GoClaw MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "GOCLAW_SERVER=${GOCLAW_SERVER}" goclaw-mcp -- npx goclaw-mcp
Required:GOCLAW_SERVER+ 6 optional
README.md

MCP server for GoClaw Gateway server management

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-mcp

Add 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-http

MCP endpoint: http://localhost:3100/mcp

Configuration

Variable Required Default Description
GOCLAW_SERVER Yes — GoClaw gateway URL
GOCLAW_TOKEN No — Bearer token (determines RBAC role)
GOCLAW_USER_ID No — Default user ID for multi-tenant scoping
GOCLAW_MCP_PORT No 3100 HTTP transport port
GOCLAW_MCP_ALLOWED_ORIGINS No localhost Comma-separated allowed origins
GOCLAW_MCP_RATE_LIMIT_RPM No 60 Rate limit per session (req/min)
GOCLAW_LOG_LEVEL No info Log level: debug, info, warn, error

Available Tools

System (3)

Tool Description
goclaw_health Check gateway health
goclaw_status Get gateway status
goclaw_models_list List available LLM models

Agents (13)

Tool Description
goclaw_agent_list List all agents
goclaw_agent_get Get agent details
goclaw_agent_create Create agent
goclaw_agent_update Update agent
goclaw_agent_delete Delete agent
goclaw_agent_files_list List context files
goclaw_agent_files_get Read context file
goclaw_agent_files_set Write context file
goclaw_agent_files_delete Delete context file
goclaw_agent_links_list List delegation links
goclaw_agent_links_set Set delegation link
goclaw_agent_links_remove Remove delegation link
goclaw_agent_share Share agent with user

Sessions (5)

Tool Description
goclaw_session_list List chat sessions
goclaw_session_preview Preview session messages
goclaw_session_delete Delete session
goclaw_session_reset Reset session history
goclaw_session_label Label a session

Configuration (3)

Tool Description
goclaw_config_get Get gateway config
goclaw_config_apply Apply full config
goclaw_config_patch Patch config fields

Providers (5)

Tool Description
goclaw_provider_list List LLM providers
goclaw_provider_get Get provider details
goclaw_provider_create Add provider
goclaw_provider_update Update provider
goclaw_provider_delete Remove provider

MCP Servers (7)

Tool Description
goclaw_mcp_server_list List registered MCP servers
goclaw_mcp_server_get Get MCP server details
goclaw_mcp_server_create Register MCP server
goclaw_mcp_server_update Update MCP server
goclaw_mcp_server_delete Remove MCP server
goclaw_mcp_server_grant_agent Grant agent access
goclaw_mcp_server_grant_user Grant user access

Skills (5)

Tool Description
goclaw_skill_list List skills
goclaw_skill_get Get skill details
goclaw_skill_update Update skill
goclaw_skill_grant_agent Grant agent access
goclaw_skill_grant_user Grant user access

Custom Tools (6)

Tool Description
goclaw_custom_tool_list List custom tools
goclaw_custom_tool_get Get tool details
goclaw_custom_tool_create Create custom tool
goclaw_custom_tool_update Update custom tool
goclaw_custom_tool_delete Delete custom tool
goclaw_custom_tool_invoke Invoke tool directly

Cron Jobs (6)

Tool Description
`goc

Tools (5)

goclaw_healthCheck gateway health
goclaw_agent_listList all agents
goclaw_session_listList chat sessions
goclaw_config_getGet gateway config
goclaw_custom_tool_invokeInvoke tool directly

Environment Variables

GOCLAW_SERVERrequiredGoClaw gateway URL
GOCLAW_TOKENBearer token (determines RBAC role)
GOCLAW_USER_IDDefault user ID for multi-tenant scoping
GOCLAW_MCP_PORTHTTP transport port
GOCLAW_MCP_ALLOWED_ORIGINSComma-separated allowed origins
GOCLAW_MCP_RATE_LIMIT_RPMRate limit per session (req/min)
GOCLAW_LOG_LEVELLog level: debug, info, warn, error

Configuration

claude_desktop_config.json
{"mcpServers": {"goclaw": {"command": "npx", "args": ["goclaw-mcp"], "env": {"GOCLAW_SERVER": "http://localhost:8080", "GOCLAW_TOKEN": "your-admin-token"}}}}

Try it

→List all currently active agents in my GoClaw gateway.
→Check the health status of the GoClaw gateway.
→Show me a list of all chat sessions and their recent activity.
→Get the current gateway configuration settings.
→List all available LLM providers configured in the gateway.

Frequently Asked Questions

What are the key features of GoClaw MCP Server?

66 MCP tools covering all GoClaw management operations. 4 MCP resources for real-time gateway context. Dual transport support for stdio and Streamable HTTP. Enterprise security features including audit logging and secret scrubbing. Type-safe implementation with full TypeScript and Zod validation.

What can I use GoClaw MCP Server for?

Managing AI agent infrastructure directly from an MCP-compatible IDE like Cursor.. Automating gateway configuration updates via AI-driven workflows.. Monitoring gateway health and session logs in real-time through an AI assistant.. Granting agent or user access to specific skills and tools programmatically..

How do I install GoClaw MCP Server?

Install GoClaw MCP Server by running: npx goclaw-mcp

What MCP clients work with GoClaw MCP Server?

GoClaw MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep GoClaw MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all ai-tools servers →

Related MCP Servers

Skill Seekers
The data layer for AI systems.
ai-tools11.1K stars
Context Mode
The other half of the context problem.
ai-tools5.6K stars
Semiotic
A React data visualization library designed for AI-assisted development.
ai-tools2.6K stars
RocketRide
Self-hosted, open-source AI pipeline platform for MCP tools
ai-tools1.6K stars
Context+
Semantic Intelligence for Large-Scale Engineering.
ai-tools1.5K stars
ShipSwift
AI-native SwiftUI component library — production-ready code for LLMs
ai-tools1.3K stars