@clawpod/mcp-server

MCP (Model Context Protocol) server for managing your ClawPod AI bot instances from Claude Code, Cursor, VS Code, and other MCP-compatible clients.

Available Tools

Tool	Description
list_bots	List all your bot instances with status, platform, and template info
get_bot	Get details of a specific bot by ID (includes live health check)
start_bot	Start a stopped bot instance
stop_bot	Stop a running bot instance
restart_bot	Restart a running bot instance
list_templates	List all 30 available agent templates (no auth required)

Setup

1. Get your API key

Go to clawpod.app/settings and generate an API key.

2. Build the package

cd packages/mcp-server
npm install
npm run build

3. Configure your MCP client

Claude Code (claude_desktop_config.json)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "clawpod": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "CLAWPOD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code CLI (.claude.json)

Add to your project's .claude.json or ~/.claude.json:

{
  "mcpServers": {
    "clawpod": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "CLAWPOD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Go to Settings > MCP Servers and add:

• Name: clawpod
• Command: node /absolute/path/to/packages/mcp-server/dist/index.js
• Environment: CLAWPOD_API_KEY=your-api-key-here

VS Code (Copilot)

Add to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "clawpod": {
        "command": "node",
        "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
        "env": {
          "CLAWPOD_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Development

npm run dev    # Watch mode (recompiles on changes)
npm run build  # One-time build
npm start      # Run the server (for testing)

API Reference

All tools communicate with the ClawPod REST API at https://clawpod.app/api/v1. Authentication is via Bearer token in the Authorization header. The list_templates tool does not require authentication.