mcp_catalog.yaml

# An agent that can discover, enable and use any remote streamable-http
# MCP server from the Docker MCP Catalog on demand.
#
# How it works:
#   - The mcp_catalog toolset adds up to 5 meta-tools:
#       * search_remote_mcp_servers   — find servers by keyword
#       * enable_remote_mcp_server    — activate one (connects now,
#         blocking on any required OAuth handshake)
#       * list_remote_mcp_servers     — show what's currently active
#       * disable_remote_mcp_server   — turn one off again
#       * reset_remote_mcp_server_auth — wipe persisted OAuth credentials
#         for a server so the next enable triggers a fresh authorization
#         flow. Useful when a token was revoked, scopes changed, or you
#         signed in to the wrong account. Only exposed once at least one
#         server is enabled; no-op for servers with no persisted
#         credentials.
#   - Tools from servers that have not been enabled stay hidden, so the
#     prompt is not flooded with hundreds of tool definitions.
#   - When the model enables a server, the underlying connection is
#     established synchronously and any required OAuth authorization URL
#     is surfaced via the elicitation pipeline, blocking until the user
#     authorizes or cancels.
#   - The catalog only includes servers docker-agent can authenticate
#     itself: those needing no credentials ("none") or an OAuth flow
#     ("oauth"). Servers requiring a caller-provided API key are
#     intentionally excluded — declare those explicitly with `type: mcp`.

agents:
  root:
    model: anthropic/claude-sonnet-4-6
    description: Agent that can on-demand connect to remote MCP servers from the Docker MCP Catalog.
    instruction: |
      You can discover and activate remote MCP servers on demand.
      Use search_remote_mcp_servers to find a server matching the
      user's intent, then enable_remote_mcp_server to activate it.
      Be conservative: enable only the servers you actually need for
      the task at hand. Disable a server with disable_remote_mcp_server
      once you are done with it.
    toolsets:
      - type: mcp_catalog