MCPBundles for OpenClaw

OpenClaw plugin that lets agents call MCPBundles-connected MCP servers through the local mcpbundles CLI.

What It Adds

• mcpbundles_hub_tools - list every Hub platform tool visible to the active MCPBundles connection.
• mcpbundles_call_hub_tool - call any Hub platform tool with JSON arguments.
• mcpbundles_get_skill - fetch the Hub platform skill or a published MCP server skill.
• mcpbundles_discover_servers - find MCP servers available through MCPBundles.
• mcpbundles_list_tools - list tools for a selected MCP server.
• mcpbundles_describe_tool - inspect the schema for a specific tool.
• mcpbundles_call_tool - call a MCPBundles-routed MCP tool with JSON arguments.

The plugin also ships a mcpbundles skill adapted from the existing MCPBundles CLI skill at .skills/mcpbundles-cli/SKILL.md. It teaches the agent to discover servers, inspect tool schemas, fetch Hub skills, use exact hash-suffixed tool names, and avoid asking users for third-party credentials.

Requirements

• OpenClaw 2026.3.24-beta.2 or newer on Node 22.19.0 or newer.
• MCPBundles CLI installed and logged in on the same host as the OpenClaw Gateway.
• Optional: configure a default MCPBundles connection when multiple named connections exist.

Install From ClawHub

openclaw plugins install clawhub:mcpbundles

Enable the optional tools in OpenClaw config:

{
  tools: {
    allow: ["mcpbundles"]
  }
}

The Gateway host needs a logged-in MCPBundles CLI:

mcpbundles login

Set command when the CLI is not on the Gateway process PATH.

Local Development Install

openclaw plugins install ./apps_on_third_party_sites/openclaw/openclaw-mcpbundles-plugin

If mcpbundles is not on the Gateway process PATH, set:

{
  plugins: {
    entries: {
      mcpbundles: {
        config: {
          command: "/opt/homebrew/bin/mcpbundles",
        },
      },
    },
  },
}

When multiple MCPBundles connections exist, set the default connection:

{
  plugins: {
    entries: {
      mcpbundles: {
        config: {
          connection: "local",
          timeoutMs: 120000,
        },
      },
    },
  },
}

ClawHub Publish

npm run build
npm run typecheck
clawhub package pack ./apps_on_third_party_sites/openclaw/openclaw-mcpbundles-plugin --pack-destination /tmp
clawhub package publish /tmp/mcpbundles-0.1.2.tgz --name mcpbundles --display-name MCPBundles --version 0.1.2