mcp start

Starts the local MCP server. You must choose a smart account and at least one session key. Session key passwords are required to unlock the keys.

Usage

namera mcp start [--smart-account <alias>] [--session-key <alias>=<password>] [--transport <stdio|http>] [--port <number>]

Aliases:

• Command alias: start -> s

Flags

• --smart-account, -sa: Smart account alias to use for the MCP server
• --session-key, -sk: Session key alias/password pair. Repeat to add multiple keys.
• --transport, -t: Transport (stdio or http, default: stdio)
• --port, -p: Port for http transport (default: 8080)

Global flags:

• --params: Raw JSON parameters for agent-driven execution
• --output, -o: pretty, json, or ndjson
• --quite, -q: Suppress output

If --smart-account or --session-key is missing, the CLI will prompt you to select them. When prompted, you will be asked for each session key password.

Params mode (agents)

Use --params with the JSON schema for the command:

namera schema mcp.start

Expected shape:

{
  "smartAccountAlias": "my-smart",
  "transport": "stdio",
  "port": 8080,
  "sessionKeys": {
    "my-key": "my-password",
    "my-other-key": "my-other-password"
  }
}

Notes:

• transport must be stdio or http
• port is only used when transport is http
• sessionKeys is a map of alias to password

Output

This command starts a long-running server and does not emit a structured response.

Examples

Single session key (stdio):

namera mcp start --smart-account my-smart --session-key my-key=my-password

HTTP transport with explicit port:

namera mcp start --smart-account my-smart --session-key my-key=my-password --transport http --port 8080

Multiple session keys:

namera mcp start --smart-account my-smart --session-key my-key=my-password --session-key my-other-key=my-other-password

Params mode (agents):

namera mcp start --params '{"smartAccountAlias":"my-smart","transport":"http","port":8080,"sessionKeys":{"my-key":"my-password","my-other-key":"my-other-password"}}'

Short alias:

namera mcp s --smart-account my-smart --session-key my-key=my-password

Schema lookup:

namera schema mcp.start