Models

A model (model connection) is one upstream LLM endpoint agents call through a Gateway. Dome routes the request, injects the provider credential, applies Rules and Guards, and records the result.

Refer to Models for how to connect providers and publish governed endpoints. Group models into Pools for routing and failover. Cap spend with Quotas. Connection, OAuth, pool, and quota tools require workspace context. Rate-card tools are organization-scoped (or authenticated-only for Dome's book and suggestions).

Models

dome_models_list

List LLM model connections in the active workspace.

dome_models_providers

List the supported provider catalog and each provider's curated model ids. Use it to discover valid provider and provider_config.model values before calling dome_models_add.

Each entry returns the provider id, the egress wire family, the default base URL (empty when operator-specific, for example Azure resource or Bedrock region), and a curated model list. Providers with an empty models array accept any model string the upstream accepts.

{
  "providers": [
    {
      "provider": "anthropic",
      "display_name": "Anthropic",
      "wire": "anthropic",
      "default_base_url": "https://api.anthropic.com",
      "models": [
        { "id": "claude-opus-4-8", "display_name": "Claude Opus 4.8", "default": true },
        { "id": "claude-sonnet-4-6", "display_name": "Claude Sonnet 4.6" }
      ]
    }
  ]
}

dome_models_get

Get an LLM model connection by name.

dome_models_add

Add an LLM model connection.

{
  "name": "dome_models_add",
  "arguments": {
    "name": "claude-sonnet",
    "provider": "anthropic",
    "provider_config": { "model": "claude-3-5-sonnet-20241022" },
    "api_key": "sk-ant-..."
  }
}

dome_models_update

Update an LLM model connection. Only provided fields change.

Provider is immutable after create — to switch providers, add a new connection.

dome_models_remove

Remove an LLM model connection. Marked destructive.

OAuth

dome_models_oauth_connect

Begin the shared-OAuth admin consent flow for a model configured with auth_method=oauth, credential_type=shared (Anthropic OAuth, Azure AAD service principal, Google Workload Identity for Vertex). Returns a one-shot URL valid for ~10 minutes.

dome_models_oauth_disconnect

Disconnect (revoke) shared-OAuth credentials for a model. Idempotent. Marked destructive.

Model rates

Organization rate-card tools. They are the MCP surface of dome models rates. Org id comes from the active context — there is no org_id argument.

Rates are integer micro-USD per 1 million tokens ($3.00/Mtok = 3000000). Every rate is a time-windowed era: [valid_from, valid_until) with valid_until unset meaning the open (current) era. Historical usage is priced at the era covering its own time, not at today's rate. dome_models_rate_set appends a new era (it closes the match's open era). dome_models_rate_era_update is the audited in-place correction of one existing era.

Source is which card won: customer (this organization's contract or association) or dome_default (Dome's published book). Provenance (origin) is where those numbers came from: seed, litellm, openrouter, merged, or customer. Resolution never branches on provenance.

dome_models_rate_defaults and dome_models_rate_suggest need authentication only — they read Dome's platform-global book. The other five require organization-scoped modelrates.manage (owners and admins hold it by default; it does not cascade from a workspace role). Reads take the write gate: contract rates are contract terms.

dome_models_rate_defaults

Show Dome's own per-model rate book (seeded families plus rates imported from the LiteLLM and OpenRouter feeds) and the byte-to-token conversion table used when a provider reports no token usage. Does not include the organization's contract rates — use dome_models_rates for those. The book is large; pass filter.

Returns rate_source: "dome_defaults", cost_basis (estimate of your upstream provider bill; never a Dome charge), rates (each row source: "dome_default", plus the four micro-USD-per-Mtok fields and bytes_per_token / bytes_per_token_source), and byte_to_token_conversion (applies_when, formula, rules, default_bytes_per_token, derived_tokens_estimate). Feed provenance (origin) is not emitted on each rate row of this view.

{
  "name": "dome_models_rate_defaults",
  "arguments": { "filter": "claude-sonnet" }
}

dome_models_rates

Show the effective model rate card for the active organization: its own contract rates and confirmed model associations (org_model_prices eras) layered over Dome's book, plus the byte-to-token divisor in force. Pass filter to narrow the card.

Returns rate_source: "effective", org_id, the same cost_basis string, rates (each row labelled source: customer or dome_default), and byte_to_token_conversion. This view does not include era ids; take price_id from dome_models_rate_history (customer segments) for dome_models_rate_era_update / dome_models_rate_remove.

{
  "name": "dome_models_rates",
  "arguments": { "filter": "claude" }
}

dome_models_rate_history

Show the pricing timeline one requested-model string resolves through for the active organization: every span of time, the era that won it (org override or Dome's book), its rates, source, and provenance (origin). Answers "what did this model cost us in June".

Returns { "segments": [ … ] }. Each segment is a half-open window (from unset = since forever; until unset = current). source is customer or dome_default. origin is seed, litellm, openrouter, merged, or customer. price_id is set only when source is customer. priced_as is set when the winning customer era is an alias.

{
  "name": "dome_models_rate_history",
  "arguments": { "model": "claude-sonnet-4-5" }
}

dome_models_rate_suggest

Suggest which Dome-owned pricing rows a custom model string most plausibly prices like (normalized fuzzy match over the imported book) — for models Dome cannot price directly, such as fine-tunes. Suggest only: a price is never silently bound. To bind one, confirm with dome_models_rate_set using priced_as.

Returns { "candidates": [ … ] }. Each candidate has model_match (the priced_as value to confirm), similarity score in (0, 1], current rates, and origin.

{
  "name": "dome_models_rate_suggest",
  "arguments": { "model": "ft:gpt-4o-mini:acme:support:abc123" }
}

dome_models_rate_set

Set the organization's own rate for a model match — a new era. The match's open era is closed at effective_from (default now) and the new one opened; historical usage keeps pricing at the eras that covered it. Give literal micro-USD-per-Mtok rates, or priced_as to bind the match to a Dome-owned row (the custom-model association — it tracks upstream price changes). The two are mutually exclusive.

effective_from and effective_until must be RFC3339 (for example 2026-08-01T00:00:00Z).

{
  "name": "dome_models_rate_set",
  "arguments": {
    "model_match": "claude-opus-5",
    "name": "Anthropic EA contract, 2026 H2",
    "input_micros_per_mtok": 3000000,
    "cache_read_micros_per_mtok": 300000,
    "cache_write_micros_per_mtok": 3750000,
    "output_micros_per_mtok": 15000000,
    "effective_from": "2026-07-01T00:00:00Z"
  }
}

{
  "name": "dome_models_rate_set",
  "arguments": {
    "model_match": "ft:gpt-4o-mini:acme:support:abc123",
    "priced_as": "gpt-4o-mini"
  }
}

{
  "name": "dome_models_rate_set",
  "arguments": {
    "model_match": "claude-sonnet-4-5",
    "input_micros_per_mtok": 3000000,
    "output_micros_per_mtok": 15000000,
    "effective_from": "2026-01-01T00:00:00Z",
    "effective_until": "2026-07-01T00:00:00Z"
  }
}

dome_models_rate_era_update

Edit one existing rate era in place — rates, alias, label, or window boundaries. This is the audited correction path for recorded pricing history: every provider-cost surface re-prices the affected span at read time the moment it lands (Dome's own bill is unaffected — it meters raw usage). Get era ids (price_id) from customer segments of dome_models_rate_history. Omitted fields keep their current values. A closed era cannot be reopened here.

Boundary moves that collide with the abutting neighbor are rejected unless adjust_adjacent is true. A move that would erase the neighbor entirely is still rejected. Setting any literal rate on an alias era is rejected — clear priced_as and supply all four rates in the same call.

{
  "name": "dome_models_rate_era_update",
  "arguments": {
    "price_id": "omp_01HZX…",
    "output_micros_per_mtok": 15000000,
    "valid_until": "2026-08-01T00:00:00Z",
    "adjust_adjacent": true
  }
}

dome_models_rate_remove

Remove the organization's rate for a model match by closing its open era. Removal is not a delete: by default the closed era is retained, so the period it covered keeps pricing at the customer's rate and only the future reverts to Dome's book.

{
  "name": "dome_models_rate_remove",
  "arguments": { "model_match": "claude-opus-5" }
}

{
  "name": "dome_models_rate_remove",
  "arguments": { "model_match": "claude-opus-5", "discard_history": true }
}

{
  "name": "dome_models_rate_remove",
  "arguments": { "price_id": "omp_01HZX…" }
}

Next steps

• Pools to route and fail over across model connections
• Quotas to cap USD spend
• Models how-to for the full workflow
• dome models rates CLI for the same rate-card surface