For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Give an agent access to the tools that are exposed by an MCP server.

Before you begin

1. Follow the Get started guide to set up agentregistry and start the agentregistry daemon.
2. Create an agent.
3. Create an MCP server.
4. Publish an MCP server.

Add an MCP server to the agent

MCP servers are referenced in the agent manifest in the spec.mcpServers block. Each MCP server that you reference in that block must be published in the registry catalog.

1. List the MCP servers that are published in the registry catalog.

   arctl get mcps

   Example output:

   NAME    TAG      DESCRIPTION
   mymcp   latest   mymcp MCP server
   

2. Add an mcpServers block to your agent definition (agent.yaml) and reference the MCP server that you want your agent to have access to.

   cat > myagent/agent.yaml <<EOF
   apiVersion: ar.dev/v1alpha1
   kind: Agent
   metadata:
     name: myagent
   spec:
     source:
       image: ghcr.io/myagent:latest
     description: myagent agent
     mcpServers:
       - kind: MCPServer
         name: mymcp
         tag: latest
   EOF

   Field	Description
   mcpServers[].kind	Must be MCPServer.
   mcpServers[].name	Name of the MCP server in agentregistry.
   mcpServers[].tag	Tag to use. If omitted, the latest tag is resolved at deploy time.

Next