Register remote MCP servers

Add an existing MCP server to the registry catalog so that it can be discovered and used by agents in the catalog.

If you have an MCP server that is publicly exposed, you can create a registry catalog entry for this MCP server by referencing the MCP server URL in your MCP server definition. After you create the catalog entry, other agents in your catalog can reference the MCP server in their agent definition to get access to the MCP server tools.

Before you begin

1. Follow one of the Get started guides to install Solo Enterprise for agentregistry, set up the arctl CLI, and connect a provider.
2. Make sure you have a running MCP server that is reachable at a URL, such as https://your-mcp-server.example.com/mcp. The example in this guide uses the MCP test server https://test-mcp.are.soloio.dev/mcp that is provided by Solo.io and comes with the following tools:
   • echo: This tool echoes back any string that you provide.
   • add: This tool adds two integer values.

Register the remote MCP server

Unlike MCP servers that you create and run locally, a remote MCP server runs outside of Solo Enterprise for agentregistry. You register it by providing its URL so the registry can catalog the server and make it available to agents.

1. Create a registry catalog entry for your remote MCP server.

   arctl apply -f - <<EOF
   apiVersion: ar.dev/v1alpha1
   kind: MCPServer
   metadata:
     name: remotemcp
   spec:
     description: Remote MCP test server
     remote:
       type: streamable-http
       url: https://test-mcp.are.soloio.dev/mcp
   EOF

   Field	Description
   metadata.name	The catalog name for the server. Use the <org>/<name> format.
   spec.remote.type	The transport type. Use streamable-http for HTTP-based MCP servers.
   spec.remote.url	The full URL of the remote MCP server, including the path, such as /mcp.

   Example output:

   ✓ MCPServer/myorg/my-remote-mcp created
   

2. Verify that the remote MCP server is registered in the catalog.

   arctl get mcp

   Example output:

   NAME              TAG      DESCRIPTION
   myorg/remotemcp   latest   Remote MCP test server
   

3. Optional: Open the registry UI to review your registered MCP server.

Next