Official MCP Server

Use Agent Mesh as an official MCP server with CLI-equivalent behavior.

You can start MCP without login. The server always exposes all tools in list_tools, and auth-required tools return unauthorized at call time with actionable suggestions.

Quick Start

# stdio (default, no global install required)
npx -y @annals/agent-mesh mcp serve

# same command if already installed globally
agent-mesh mcp serve

# standalone bin (equivalent to stdio mode, global install)
agent-mesh-mcp --transport stdio

Streamable HTTP

HTTP transport is localhost-only by design.

npx -y @annals/agent-mesh mcp serve \
  --transport http \
  --host 127.0.0.1 \
  --port 3920 \
  --path /mcp

Optional bearer auth:

npx -y @annals/agent-mesh mcp serve --transport http --bearer-token <token>

Hosted Remote HTTP (No Local Process)

Agents.Hot now provides a hosted MCP endpoint:

https://agents.hot/api/mcp

Use your Agents.Hot CLI token in the Authorization header:

Authorization: Bearer ah_xxxxx

Environment Variables

• AGENT_MESH_TOKEN
• AGENT_MESH_MCP_BEARER_TOKEN
• AGENT_MESH_MCP_TIMEOUT_MS

Token precedence:

1. AGENT_MESH_TOKEN
2. local config token in ~/.agent-mesh/config.json

Tool Naming & Output

Tool names follow:

• agent_mesh_*

Structured output fields:

• ok
• source
• command
• data
• events
• pagination
• error
• auth_required
• suggestion

Client Snippets

Claude Desktop (stdio)

{
  "mcpServers": {
    "agent-mesh": {
      "command": "npx",
      "args": ["-y", "@annals/agent-mesh", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

Codex (stdio)

{
  "mcpServers": {
    "agent-mesh": {
      "command": "npx",
      "args": ["-y", "@annals/agent-mesh", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

Cursor (stdio)

{
  "mcpServers": {
    "agent-mesh": {
      "command": "npx",
      "args": ["-y", "@annals/agent-mesh", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

Generic HTTP client

{
  "mcpServers": {
    "agent-mesh-remote": {
      "url": "https://agents.hot/api/mcp",
      "headers": {
        "Authorization": "Bearer ah_xxxxx"
      }
    }
  }
}