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

Use the built-in MCP server scaffolding capability in Solo Enterprise for agentregistry to create an MCP server with a fetch tool, and run it on your local machine.

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. Install uv so that you can run MCP servers locally.

Create an MCP server

Solo Enterprise for agentregistry comes with built-in MCP server templates that you can use to quickly spin up MCP servers or customize them to your needs.

1. Create an MCP server.

   The following command creates a mymcp FastMCP Python server with an echo and sum tool. When you run the command, a mymcp directory is created on your local machine that contains the scaffold for your MCP server. You also see the port that is configured for the MCP server. Note the port as you need it later when connecting to the MCP server by using the MCP Inspector tool.

   arctl init mcp mymcp --framework fastmcp --language python

   Note

   Want to see available options as you configure your MCP server? Try out the interactive CLI mode that walks you through the details for your agent scaffold. Simply run arctl init mcp to start the CLI in interactive mode.

   Example output:

   ✓ Created MCP server: mymcp (framework: fastmcp, language: python, transport: http, port: 3000)
   
   🚀 Next steps:
     1. Run locally (optional):
        arctl run mymcp
     2. Publish to the registry:
        arctl apply -f mymcp/mcp.yaml
   

2. Explore the MCP server scaffold that was created for you. You can optionally make changes to the files to customize your MCP server further.

   ls -R mymcp

   Example output:

   Dockerfile     mcp.yaml       pyproject.toml README.md      src            tests
   
   mymcp/src:
   core    main.py tools
   
   mymcp/src/core:
   __init__.py server.py   utils.py
   
   mymcp/src/tools:
   __init__.py echo.py sum.py
   
   mymcp/tests:
   test_discovery.py test_server.py    test_tools.py
   

   File	Description
   arctl.yaml	The MCP server details that you specified with the arctl CLI.
   Dockerfile	The Dockerfile to spin up and run your MCP server in a containerized environment.
   mcp.yaml	The MCP server configuration file that defines server metadata, transport settings, version, and other server-specific configuration.
   pyproject.toml	The Python project configuration file that defines project dependencies, build settings, and metadata for the MCP server.
   README.md	An introduction to the MCP server that you created with instructions for how to further customize it.
   src	A directory that contains the details of the MCP server, such as supported tools and the Python script to bootstrap and run the server.
   src.core	A directory that contains the MCP server source code files.
   src.tools	A directory that defines the tools that the MCP server can use. The sample scaffold includes an echo and a sum tool.
   tests	A directory that contains generated tests.

Run the MCP server

1. Run the MCP server on your local machine. The following command builds the MCP server image on your local machine and opens the MCP Inspector tool so that you can connect to the server and access its tools.

   arctl run mymcp --inspector

   Example output:

   ...
   → fastmcp-python: docker run --rm -p 3000:3000 localhost:5001/mymcp:latest --transport http --host 0.0.0.0 --port 3000
   2026-05-14 18:39:46,327 - INFO - Loaded tool module: sum
   2026-05-14 18:39:46,329 - INFO - Loaded tool module: echo
   2026-05-14 18:39:46,329 - INFO - 📦 Successfully loaded 2 tools
   2026-05-14 18:39:46,549 - INFO - HTTP Request: GET https://pypi.org/pypi/fastmcp/json "HTTP/1.1 200 OK"
   ...
   
   [05/14/26 18:39:46] INFO     Starting MCP server 'mymcp' with   transport.py:301
                             transport 'http' on                                
                             http://0.0.0.0:3000/mcp    
   
   Starting MCP inspector...
   ⚙️ Proxy server listening on localhost:6277
   🔑 Session token: c3642ae11a0db7def05e2949631ae2cd3171119016627e69f420706d25b2846d
      Use this token to authenticate requests or set DANGEROUSLY_OMIT_AUTH=true to disable auth
   
   🚀 MCP Inspector is up and running at:
      http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=c3642ae11a0db7def05e2949631ae2cd3171119016627e69f420706d25b2846d         
   

2. In the MCP Inspector, 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:3000/mcp.
   • Click Connect.

3. Try out an MCP tool.

   1. In the MCP Inspector tool, click Connect.
   2. Navigate to the Tools tab and click List Tools. Verify that you see the example_sum and example_echo tool.
   3. Choose the example_echo tool and enter any string into the message field.
   4. Click Run Tool to execute the tool. Verify that you see your message echoed back to you.

   

   

4. Exit the MCP Inspector by using the ctrl + c keys.

Next