Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GoClaw MCP Serverlist all my active agents and their status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
goclaw-mcp
MCP (Model Context Protocol) server for GoClaw Gateway server management. Enables AI assistants like Claude, Cursor, and other MCP clients to manage your GoClaw AI gateway infrastructure.
Features
66 MCP tools covering all GoClaw management operations
4 MCP resources for real-time gateway context
4 MCP prompts for guided workflows
Dual transport: stdio (local) + Streamable HTTP (production)
Enterprise security: audit logging, rate limiting, secret scrubbing, origin validation
Type-safe: Full TypeScript with Zod schema validation
Quick Start
stdio (Claude Code, Cursor, etc.)
npx goclaw-mcpAdd to your MCP client config:
Claude Code (~/.claude.json):
{
"mcpServers": {
"goclaw": {
"command": "npx",
"args": ["goclaw-mcp"],
"env": {
"GOCLAW_SERVER": "http://localhost:8080",
"GOCLAW_TOKEN": "your-admin-token"
}
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"goclaw": {
"command": "npx",
"args": ["goclaw-mcp"],
"env": {
"GOCLAW_SERVER": "http://localhost:8080",
"GOCLAW_TOKEN": "your-admin-token"
}
}
}
}Streamable HTTP (production, multi-client)
GOCLAW_SERVER=http://localhost:8080 \
GOCLAW_TOKEN=your-token \
GOCLAW_MCP_PORT=3100 \
npx goclaw-mcp-httpMCP endpoint: http://localhost:3100/mcp
Configuration
Variable | Required | Default | Description |
| Yes | — | GoClaw gateway URL |
| No | — | Bearer token (determines RBAC role) |
| No | — | Default user ID for multi-tenant scoping |
| No |
| HTTP transport port |
| No |
| Comma-separated allowed origins |
| No |
| Rate limit per session (req/min) |
| No |
| Log level: debug, info, warn, error |
Available Tools
System (3)
Tool | Description |
| Check gateway health |
| Get gateway status |
| List available LLM models |
Agents (13)
Tool | Description |
| List all agents |
| Get agent details |
| Create agent |
| Update agent |
| Delete agent |
| List context files |
| Read context file |
| Write context file |
| Delete context file |
| List delegation links |
| Set delegation link |
| Remove delegation link |
| Share agent with user |
Sessions (5)
Tool | Description |
| List chat sessions |
| Preview session messages |
| Delete session |
| Reset session history |
| Label a session |
Configuration (3)
Tool | Description |
| Get gateway config |
| Apply full config |
| Patch config fields |
Providers (5)
Tool | Description |
| List LLM providers |
| Get provider details |
| Add provider |
| Update provider |
| Remove provider |
MCP Servers (7)
Tool | Description |
| List registered MCP servers |
| Get MCP server details |
| Register MCP server |
| Update MCP server |
| Remove MCP server |
| Grant agent access |
| Grant user access |
Skills (5)
Tool | Description |
| List skills |
| Get skill details |
| Update skill |
| Grant agent access |
| Grant user access |
Custom Tools (6)
Tool | Description |
| List custom tools |
| Get tool details |
| Create custom tool |
| Update custom tool |
| Delete custom tool |
| Invoke tool directly |
Cron Jobs (6)
Tool | Description |
| List cron jobs |
| Create cron job |
| Update cron job |
| Delete cron job |
| Enable/disable cron |
| Trigger cron immediately |
Teams (5)
Tool | Description |
| List teams |
| Get team details |
| Create team |
| Update team |
| Delete team |
Traces (2)
Tool | Description |
| List LLM execution traces |
| Get trace with spans |
Channels (2)
Tool | Description |
| List messaging channels |
| Enable/disable channel |
Memory (4)
Tool | Description |
| List memory documents |
| Read memory document |
| Store memory document |
| Delete memory document |
Resources
URI | Description |
| Gateway status summary |
| Available LLM models |
| All agents summary |
| Current gateway config |
Prompts
Prompt | Description |
| Guide through creating a new agent |
| Systematic troubleshooting |
| Review config for improvements |
| Optimize agent settings |
Security
Built for enterprise environments:
Secret scrubbing — Tokens, API keys, passwords never appear in logs
Audit logging — Every tool invocation logged with structured JSON
Rate limiting — Token bucket per session (HTTP transport)
Origin validation — DNS rebinding prevention
Input validation — Zod schemas on all tool parameters
Auth passthrough — Bearer token forwarded to GoClaw RBAC
Development
# Install
pnpm install
# Build
pnpm build
# Test
pnpm test
# Type check
pnpm lint
# Dev mode (watch)
pnpm devLicense
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.