akka mcp serve

Start the MCP server.

Synopsis

Start an MCP server that exposes Akka CLI operations as MCP tools.

By default, the server uses stdio transport for IDE integration (Claude Desktop, VS Code, Cursor). All toolsets are enabled by default.

Configure in Claude Desktop or VS Code:

{ "mcpServers": { "akka": { "command": "akka", "args": ["mcp", "serve"] } } }

akka mcp serve [flags]

Examples

  akka mcp serve                              # all toolsets, stdio
  akka mcp serve --toolsets projects,services  # only these toolsets
  akka mcp serve --toolsets all                # explicitly enable all

Options

  -h, --help              help for serve
      --toolsets string   Comma-separated list of toolsets to enable (default: all). Available: projects, services, routes, descriptor, sdd, local, build, git

Options inherited from parent commands

      --cache-file string   location of cache file (default "~/.akka/cache.yaml")
      --config string       location of config file (default "~/.akka/config.yaml")
      --context string      configuration context to use
      --disable-prompt      Disable all interactive prompts when running akka commands. If input is required, defaults will be used, or an error will be raised.
                            This is equivalent to setting the environment variable AKKA_DISABLE_PROMPTS to true.
  -o, --output string       set output format to one of [text,json,json-compact,go-template=] (default "text")
      --page-mode string    the mode for paging, either paged, buffered or auto. (default "auto")
  -q, --quiet               set quiet output (helpful when used as part of a script)
      --timeout duration    client command timeout (default 10s)
      --use-grpc-web        use grpc-web when talking to Akka APIs. This is useful when behind corporate firewalls that decrypt traffic but don't support HTTP/2.
  -v, --verbose             set verbose output

SEE ALSO

  • akka mcp - MCP server for AI agent integration.