Local

Deploy an MCP server from agentregistry to your local environment.

Local deployments spin up Docker containers on your local machine from images that exist on your machine or that can be pulled from the image location reference that agentregistry points to.

Before you begin

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

Deploy the MCP server

1. List the MCP servers that are published to agentregistry.

   arctl mcp list

   Example output:

   NAME                 VERSION   TYPE   DEPLOYED   UPDATED
   user/my-mcp-server   0.1.0     oci    False      2h

2. Deploy the MCP server to your local environment. The following command spins up a Docker container from the user/my-mcp-server artifact reference that is published in agentregistry. In your CLI output, get the address that the MCP server is exposed on.

   arctl deployments create user/my-mcp-server \
    --type mcp \
    --version 0.1.0

   Example output:

   Deployed user/my-mcp-server (v0.1.0) with providerId=local
   
   Server deployment recorded. The registry will reconcile containers automatically.
   Agent Gateway endpoint: http://localhost:21212/mcp
   
   If the deployment fails, a deployment entry is still created in the database and set to failed. You can view failed deployments by using the arctl deployments list command. Note that you cannot re-deploy a failed deployment to fix it. Instead, remove the failed deployment with arctl deployments delete <deployment-ID> and then re-run the arctl deployments create command.

3. Open the MCP inspector.

   npx modelcontextprotocol/inspector#0.18.0

4. Connect to your MCP server. Enter the following details.

   • Transport type: Select Streamable HTTP.
   • URL: The MCP server URL that you retrieved earlier, such as http://localhost:21212/mcp.
   • Click Connect.

5. Go to the Tools tab and verify that you see the newly added add_number tool. Try out the tool by entering two integer numbers, such as 5 and 3. Then, click Run Tool. Verify that the sum of both numbers is returned.

   

   

Cleanup

You can remove a deployment from the UI or CLI.