GoClaw MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOCLAW_TOKEN | No | Bearer token (determines RBAC role) | |
| GOCLAW_SERVER | Yes | GoClaw gateway URL | |
| GOCLAW_USER_ID | No | Default user ID for multi-tenant scoping | |
| GOCLAW_MCP_PORT | No | HTTP transport port | 3100 |
| GOCLAW_LOG_LEVEL | No | Log level: debug, info, warn, error | info |
| GOCLAW_MCP_RATE_LIMIT_RPM | No | Rate limit per session (req/min) | 60 |
| GOCLAW_MCP_ALLOWED_ORIGINS | No | Comma-separated allowed origins | localhost |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| goclaw_healthB | Check GoClaw gateway health status |
| goclaw_statusA | Get GoClaw gateway status including version, uptime, and connection counts |
| goclaw_models_listA | List all available LLM models across all configured providers |
| goclaw_agent_listB | List all agents configured in GoClaw gateway |
| goclaw_agent_getC | Get detailed information about a specific agent |
| goclaw_agent_createC | Create a new agent in GoClaw gateway |
| goclaw_agent_updateC | Update an existing agent's settings |
| goclaw_agent_deleteC | Delete an agent (soft delete) |
| goclaw_agent_files_listB | List context files (SOUL.md, IDENTITY.md, etc.) for an agent |
| goclaw_agent_files_getC | Read a specific context file for an agent |
| goclaw_agent_files_setC | Create or update a context file for an agent |
| goclaw_agent_files_deleteC | Delete a context file from an agent |
| goclaw_agent_links_listB | List delegation links for an agent (which agents it can delegate to) |
| goclaw_agent_links_setC | Create or update a delegation link between agents |
| goclaw_agent_links_removeC | Remove a delegation link between agents |
| goclaw_agent_shareC | Share an agent with a user |
| goclaw_session_listB | List chat sessions, optionally filtered by agent |
| goclaw_session_previewC | Preview recent messages in a chat session |
| goclaw_session_deleteB | Delete a chat session permanently |
| goclaw_session_resetB | Reset a chat session (clear message history) |
| goclaw_session_labelB | Set a label/title for a chat session |
| goclaw_config_getB | Get current GoClaw gateway configuration (or a specific section) |
| goclaw_config_applyA | Apply a full configuration to the GoClaw gateway (overwrites current config). Use with caution. |
| goclaw_config_patchC | Patch specific fields in the GoClaw gateway configuration |
| goclaw_provider_listB | List all configured LLM providers |
| goclaw_provider_getB | Get details of a specific LLM provider |
| goclaw_provider_createC | Add a new LLM provider to GoClaw |
| goclaw_provider_updateC | Update an LLM provider's configuration |
| goclaw_provider_deleteC | Remove an LLM provider from GoClaw |
| goclaw_mcp_server_listB | List all registered MCP servers in GoClaw |
| goclaw_mcp_server_getB | Get details of a registered MCP server |
| goclaw_mcp_server_createB | Register a new MCP server in GoClaw |
| goclaw_mcp_server_updateC | Update a registered MCP server's configuration |
| goclaw_mcp_server_deleteC | Remove a registered MCP server from GoClaw |
| goclaw_mcp_server_grant_agentC | Grant an agent access to an MCP server |
| goclaw_mcp_server_grant_userC | Grant a user access to an MCP server |
| goclaw_skill_listB | List all available skills in GoClaw |
| goclaw_skill_getB | Get details of a specific skill |
| goclaw_skill_updateC | Update a skill's metadata |
| goclaw_skill_grant_agentB | Grant an agent access to a skill |
| goclaw_skill_grant_userC | Grant a user access to a skill |
| goclaw_custom_tool_listC | List custom tools defined in GoClaw |
| goclaw_custom_tool_getC | Get details of a custom tool |
| goclaw_custom_tool_createC | Create a new custom tool in GoClaw |
| goclaw_custom_tool_updateC | Update a custom tool's definition |
| goclaw_custom_tool_deleteC | Delete a custom tool from GoClaw |
| goclaw_custom_tool_invokeD | Invoke a custom tool directly with arguments |
| goclaw_cron_listB | List all cron jobs in GoClaw |
| goclaw_cron_createC | Create a new cron job |
| goclaw_cron_updateC | Update a cron job's settings |
| goclaw_cron_deleteC | Delete a cron job |
| goclaw_cron_toggleC | Enable or disable a cron job |
| goclaw_cron_runC | Trigger a cron job to run immediately |
| goclaw_team_listB | List all teams in GoClaw |
| goclaw_team_getC | Get team details |
| goclaw_team_createC | Create a new agent team |
| goclaw_team_updateC | Update a team's settings |
| goclaw_team_deleteC | Delete a team |
| goclaw_trace_listB | List LLM execution traces with cost and token usage |
| goclaw_trace_getB | Get detailed trace with individual LLM call spans |
| goclaw_channel_listB | List all messaging channels (Telegram, Discord, etc.) |
| goclaw_channel_toggleC | Enable or disable a messaging channel |
| goclaw_memory_listB | List memory documents stored for an agent |
| goclaw_memory_getB | Read a memory document's content |
| goclaw_memory_createC | Store a new memory document for an agent |
| goclaw_memory_deleteC | Delete a memory document |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| goclaw_setup_agent | Guide through creating and configuring a new GoClaw agent |
| goclaw_troubleshoot | Systematic troubleshooting of GoClaw gateway issues |
| goclaw_review_config | Review current GoClaw configuration for issues or improvements |
| goclaw_optimize_agent | Suggest optimizations for an agent's settings and behavior |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| goclaw://status | |
| goclaw://models | |
| goclaw://agents | |
| goclaw://config |
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.