GoClaw MCP Server
Click on "Deploy 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 Server list 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
Related MCP server: DLF Agency MCP Server
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
Available Tools
66 toolsgoclaw_agent_createC
Create a new agent in GoClaw gateway
Inputs: agent_key (required), display_name (required), provider, model, +4 more.
goclaw_agent_deleteC
Delete an agent (soft delete)
Inputs: id (required).
goclaw_agent_files_deleteC
Delete a context file from an agent
Inputs: agent_id (required), path (required).
goclaw_agent_files_getC
Read a specific context file for an agent
Inputs: agent_id (required), path (required).
goclaw_agent_files_listB
List context files (SOUL.md, IDENTITY.md, etc.) for an agent
Inputs: agent_id (required).
goclaw_agent_files_setC
Create or update a context file for an agent
Inputs: agent_id (required), path (required), content (required).
goclaw_agent_getC
Get detailed information about a specific agent
Inputs: id (required).
goclaw_agent_links_listB
List delegation links for an agent (which agents it can delegate to)
Inputs: agent_id (required).
goclaw_agent_links_removeC
Remove a delegation link between agents
Inputs: agent_id (required), target_agent_id (required).
goclaw_agent_links_setC
Create or update a delegation link between agents
Inputs: agent_id (required), target_agent_id (required), description (required).
goclaw_agent_listB
List all agents configured in GoClaw gateway
Inputs: include_deleted.
goclaw_agent_updateC
Update an existing agent's settings
Inputs: id (required), display_name, provider, model, +3 more.
goclaw_channel_listB
List all messaging channels (Telegram, Discord, etc.)
Inputs: no named parameters.
goclaw_channel_toggleC
Enable or disable a messaging channel
Inputs: channel (required), enabled (required).
goclaw_config_applyA
Apply a full configuration to the GoClaw gateway (overwrites current config). Use with caution.
Inputs: config (required).
goclaw_config_getB
Get current GoClaw gateway configuration (or a specific section)
Inputs: section.
goclaw_config_patchC
Patch specific fields in the GoClaw gateway configuration
Inputs: patches (required).
goclaw_cron_createC
Create a new cron job
Inputs: name (required), expression (required), agent_id (required), message (required), +1 more.
goclaw_cron_deleteC
Delete a cron job
Inputs: id (required).
goclaw_cron_listB
List all cron jobs in GoClaw
Inputs: no named parameters.
goclaw_cron_runC
Trigger a cron job to run immediately
Inputs: id (required).
goclaw_cron_toggleC
Enable or disable a cron job
Inputs: id (required), enabled (required).
goclaw_cron_updateC
Update a cron job's settings
Inputs: id (required), name, expression, agent_id, +1 more.
goclaw_custom_tool_createC
Create a new custom tool in GoClaw
Inputs: name (required), description (required), parameters (required), command (required), +2 more.
goclaw_custom_tool_deleteC
Delete a custom tool from GoClaw
Inputs: id (required).
goclaw_custom_tool_getC
Get details of a custom tool
Inputs: id (required).
goclaw_custom_tool_invokeD
Invoke a custom tool directly with arguments
Inputs: id (required), args (required).
goclaw_custom_tool_listC
List custom tools defined in GoClaw
Inputs: agent_id.
goclaw_custom_tool_updateC
Update a custom tool's definition
Inputs: id (required), name, description, command, +1 more.
goclaw_healthB
Check GoClaw gateway health status
Inputs: no named parameters.
goclaw_mcp_server_createB
Register a new MCP server in GoClaw
Inputs: name (required), transport (required), command, args, +5 more.
goclaw_mcp_server_deleteC
Remove a registered MCP server from GoClaw
Inputs: id (required).
goclaw_mcp_server_getB
Get details of a registered MCP server
Inputs: id (required).
goclaw_mcp_server_grant_agentC
Grant an agent access to an MCP server
Inputs: server_id (required), agent_id (required).
goclaw_mcp_server_grant_userC
Grant a user access to an MCP server
Inputs: server_id (required), user_id (required).
goclaw_mcp_server_listB
List all registered MCP servers in GoClaw
Inputs: no named parameters.
goclaw_mcp_server_updateC
Update a registered MCP server's configuration
Inputs: id (required), name, transport, command, +3 more.
goclaw_memory_createC
Store a new memory document for an agent
Inputs: agent_id (required), path (required), content (required).
goclaw_memory_deleteC
Delete a memory document
Inputs: id (required).
goclaw_memory_getB
Read a memory document's content
Inputs: id (required).
goclaw_memory_listB
List memory documents stored for an agent
Inputs: agent_id (required), user_id.
goclaw_models_listA
List all available LLM models across all configured providers
Inputs: no named parameters.
goclaw_provider_createC
Add a new LLM provider to GoClaw
Inputs: name (required), type (required), api_key (required), base_url, +1 more.
goclaw_provider_deleteC
Remove an LLM provider from GoClaw
Inputs: id (required).
goclaw_provider_getB
Get details of a specific LLM provider
Inputs: id (required).
goclaw_provider_listB
List all configured LLM providers
Inputs: no named parameters.
goclaw_provider_updateC
Update an LLM provider's configuration
Inputs: id (required), name, api_key, base_url, +2 more.
goclaw_session_deleteB
Delete a chat session permanently
Inputs: session_key (required).
goclaw_session_labelB
Set a label/title for a chat session
Inputs: session_key (required), label (required).
goclaw_session_listB
List chat sessions, optionally filtered by agent
Inputs: agent_id, limit.
goclaw_session_previewC
Preview recent messages in a chat session
Inputs: session_key (required), limit.
goclaw_session_resetB
Reset a chat session (clear message history)
Inputs: session_key (required).
goclaw_skill_getB
Get details of a specific skill
Inputs: id (required).
goclaw_skill_grant_agentB
Grant an agent access to a skill
Inputs: skill_id (required), agent_id (required).
goclaw_skill_grant_userC
Grant a user access to a skill
Inputs: skill_id (required), user_id (required).
goclaw_skill_listB
List all available skills in GoClaw
Inputs: no named parameters.
goclaw_skill_updateC
Update a skill's metadata
Inputs: id (required), name, description, enabled.
goclaw_statusA
Get GoClaw gateway status including version, uptime, and connection counts
Inputs: no named parameters.
goclaw_team_createC
Create a new agent team
Inputs: name (required), member_agent_ids (required), description.
goclaw_team_deleteC
Delete a team
Inputs: id (required).
goclaw_team_getC
Get team details
Inputs: id (required).
goclaw_team_listB
List all teams in GoClaw
Inputs: no named parameters.
goclaw_team_updateC
Update a team's settings
Inputs: id (required), name, description, member_agent_ids.
goclaw_trace_getB
Get detailed trace with individual LLM call spans
Inputs: trace_id (required).
goclaw_trace_listB
List LLM execution traces with cost and token usage
Inputs: agent_id, limit, status.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 66 tools
Tools are well-organized by resource categories (agent, config, cron, custom_tool, etc.) with clear CRUD operations, making most tools distinct. However, some overlap exists within categories like goclaw_agent_files_set and goclaw_agent_files_create/update are implied but not explicitly separate, and goclaw_health vs goclaw_status might cause minor confusion as both relate to system status.
Naming follows a highly consistent pattern throughout: all tools use snake_case with the prefix 'goclaw_', followed by resource name (e.g., agent, config), and then action verb (e.g., create, list, get, update, delete). This uniformity makes the tool set predictable and easy to navigate.
With 66 tools, the count is excessive for an MCP server, likely overwhelming for agents and indicating poor scoping. While the domain (GoClaw gateway management) is broad, this many tools suggests fragmentation rather than a cohesive set, making it difficult to manage and use effectively.
The tool set provides comprehensive coverage for managing a GoClaw gateway, including agents, channels, config, cron jobs, custom tools, MCP servers, memory, models, providers, sessions, skills, teams, and traces. Each category has full CRUD operations and additional utilities, leaving no obvious gaps for the inferred domain.
Maintenance
Related MCP Connectors
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Security gateway for AI agents: policy, approval, and audited execution, no secrets shared.
Zero-trust gateway for AI agents: score tool calls, verify agent cards, enforce policy, audit.
MCP gateway: one connection for your AI apps, with tool policies, PII redaction and audit logs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceBridges AI assistants with OpenClaw Gateway, enabling them to chat with OpenClaw agents, manage sessions, and read agent workspace files.1,414 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage GoHighLevel workspaces through natural language, with 508 tools across 18 domains for complete CRM, marketing, and workflow automation.Apache 2.0
- AlicenseCqualityAmaintenanceOperate the OpenClaw gateway's full management surface from any MCP client — list and trigger crons, inspect sessions, configure agents and channels, manage skills and secrets, pair devices, and more via 134 typed tools.143119 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to securely reach enterprise tools and other agents through a governed gateway with pinned tool definitions, delegated authorization, content inspection, human approval, and signed audit trails.Apache 2.0