arctl mcp run

agentregistry

Reference

CLI

arctl mcp run

Run an MCP server locally.

You can run either:

A server from the registry by name (e.g., arctl mcp run @modelcontextprotocol/server-everything)
A local MCP project by path (e.g., arctl mcp run . or arctl mcp run ./my-mcp-server)

For local projects, the server is automatically built before running. Use --no-build to skip the build step.

Usage

arctl mcp run <server-name|path> [flags]

Examples:

arctl mcp run @modelcontextprotocol/server-everything
arctl mcp run ./my-mcp-server --inspector
arctl mcp run . -e KEY=VALUE --arg ARG=value

Command-specific flags

    --arg stringArray      Runtime arguments (key=value)
    --build                Build the MCP server before running (default true)
-e, --env stringArray      Environment variables (key=value)
    --header stringArray   Headers for remote servers (key=value)
    --inspector            Launch MCP Inspector to interact with the server
    --verbose              Enable verbose logging
    --version string       Specify the version of the server to run
-y, --yes                  Automatically accept all prompts (use default values)

Global flags

-h, --help: Display help information for the command.

arctl mcp publish arctl mcp show