Skip to main content
Glama

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

goclaw_cron_list

List cron jobs

goclaw_cron_create

Create cron job

goclaw_cron_update

Update cron job

goclaw_cron_delete

Delete cron job

goclaw_cron_toggle

Enable/disable cron

goclaw_cron_run

Trigger cron immediately

Teams (5)

Tool

Description

goclaw_team_list

List teams

goclaw_team_get

Get team details

goclaw_team_create

Create team

goclaw_team_update

Update team

goclaw_team_delete

Delete team

Traces (2)

Tool

Description

goclaw_trace_list

List LLM execution traces

goclaw_trace_get

Get trace with spans

Channels (2)

Tool

Description

goclaw_channel_list

List messaging channels

goclaw_channel_toggle

Enable/disable channel

Memory (4)

Tool

Description

goclaw_memory_list

List memory documents

goclaw_memory_get

Read memory document

goclaw_memory_create

Store memory document

goclaw_memory_delete

Delete memory document

Resources

URI

Description

goclaw://status

Gateway status summary

goclaw://models

Available LLM models

goclaw://agents

All agents summary

goclaw://config

Current gateway config

Prompts

Prompt

Description

goclaw_setup_agent

Guide through creating a new agent

goclaw_troubleshoot

Systematic troubleshooting

goclaw_review_config

Review config for improvements

goclaw_optimize_agent

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 dev

License

MIT

Available Tools

66 tools
goclaw_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_listB

List all agents configured in GoClaw gateway

Inputs: include_deleted.

goclaw_agent_shareC

Share an agent with a user

Inputs: agent_id (required), user_id (required).

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

    B3/5.0

    Scored across 66 tools

    Disambiguation4/5

    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 Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      C
      quality
      A
      maintenance
      Operate 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.
      143
      119 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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