Skip to main content

​
High-level overview

A resource is a workspace record for something callable. Dome stores how to reach it, how to authenticate outbound, and how it participates in Gateways and Rules. The agent never holds the upstream credential. Membership on a Gateway makes the resource addressable. Rules decide whether a specific call is allowed. Dome supports three resource types: Attaching resources and calling them looks like this:
  1. An operator adds a Notion MCP tool and an Anthropic model connection, puts both on a Gateway, and grants an agent access.
  2. The agent discovers tools over MCP and names a model or pool on chat requests.
  3. Dome authenticates the agent, checks Gateway membership and Rules, injects credentials on egress, and audits the outcome against that resource.
Resources are the callable side of Connect. Gateways package which ones an agent can reach.

​
Reachability vs authorization

A resource can exist without being callable. Until it is a member of a Gateway an agent may use, it stays Unreachable. Membership and access grants package reachability. Rules, Guards, and Quotas still decide what happens after the call is admitted. Refer to Gateways concept.

​
Tools vs models

Tools act on the world through MCP (and related protocols). Models produce completions through the LLM ingress. Both are resources, but they use different Gateway path suffixes, credential shapes, and Guard kinds. Pools apply only to model traffic.

​
Direct models vs pools

Agents can name a model connection directly or name a pool. Prefer a pool when the client should stay stable while you swap providers, weight traffic, or fail over. Prefer a direct connection when one endpoint should always serve that name. Details are on the Models concept and Pools concept.

​
Next steps

With that resources model in mind, continue with:
  • Architecture concept for where resources sit among components
  • Tools concept for MCP connections, credentials, and catalogs
  • Models concept for provider connections and attributes
  • Pools concept for routing, failover, and resolution
  • Gateways concept for membership and reachability
  • Tools, Models, and Pools to configure them