Skip to main content
Expose AgentHeaven toolkits to any Model Context Protocol client. Build a toolkit once, then serve it as an MCP server that any compatible host can connect to.
See Toolkits for how to build toolkits and First MCP Toolkit for a step-by-step quickstart.

Serving a Toolkit via MCP

After building a toolkit (see Toolkits), serve it as an MCP server:
# stdio transport (for local clients like Claude Desktop, VS Code)
ahvn mcp serve <toolkit_name>

# HTTP transport (for remote clients or browser-based tools)
ahvn mcp serve <toolkit_name> --http --port 8080

Claude Desktop

Add the server to your Claude Desktop configuration (claude_desktop_config.json):
{
  "mcpServers": {
    "my_toolkit": {
      "command": "ahvn",
      "args": ["mcp", "serve", "my_toolkit"]
    }
  }
}
Restart Claude Desktop — the toolkit’s tools will appear in the tool picker.

VS Code (GitHub Copilot)

Add to your .vscode/mcp.json:
{
  "servers": {
    "my_toolkit": {
      "command": "ahvn",
      "args": ["mcp", "serve", "my_toolkit"]
    }
  }
}
The tools appear in Copilot Chat when agent mode is enabled.

Cursor

Add to Cursor’s MCP settings (Settings → MCP Servers → Add):
{
  "mcpServers": {
    "my_toolkit": {
      "command": "ahvn",
      "args": ["mcp", "serve", "my_toolkit"]
    }
  }
}

Further Exploration

Related: