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

arctl init mcp

Page as Markdown

Scaffold an MCP server project with YAML and framework stubs.

Scaffold a new MCP server project with declarative YAML and framework stubs.

NAME must be DNS-1123 subdomain: lowercase alphanumeric, hyphens, and dots; max 253 chars; each dot-separated segment must start and end with alphanumeric (max 63 chars per segment). Picks a framework + language interactively (or via --framework / --language).

Usage

arctl init mcp NAME [flags]

Examples:

arctl init mcp my-mcp
arctl init mcp my-mcp --framework fastmcp --language python
arctl init mcp my-stdio --framework fastmcp --language python --transport stdio

Command-specific flags

    --description string   MCP server description
    --framework string     Framework. Skips picker.
    --image string         Image tag override
    --language string      Language. Skips picker.
    --port int             HTTP port the MCP server binds to (and that arctl run maps) (default 3000)
    --transport string     MCP transport: "http" (Streamable HTTP, listens on --port) or "stdio" (stdin/stdout). Defaults to http when omitted.

Global flags

-h, --help                    Display help information for the command.
    --output-dir string       Parent directory under which the project is created. Defaults to the current directory.
    --registry-token string   Registry bearer token (defaults to value of ARCTL_API_TOKEN env var)
    --registry-url string     Registry URL (overrides ARCTL_API_BASE_URL env var; defaults to http://localhost:12121)

See also

  • arctl init - Scaffold a declarative agent, MCP, skill, or prompt project