Reference

MCP server

Let AI agents search, list, analyze and buy bundles on your behalf using the Model Context Protocol.

transport = stdio · requires = Node.js 18+ · OCB API key

What is the MCP server?

The OpenClawBundles MCP server lets any Model Context Protocol client — Claude Code, Claude Desktop, Cursor, Gemini, Windsurf and others — talk to the marketplace over stdio. The agent gets a set of tools (search, get, buy, download, analytics…) authenticated with your API key. Both creator and buyer flows are supported in the same key, with separate scopes so you decide what the agent is allowed to do.

Before you start

Install Node.js 18 or newer (the server runs via npx).
Create an API key at /dashboard/creator/api-keys with the scopes you need. Recommended for an all-purpose agent: products:read, analytics:read, downloads:read, purchases:write. Add products:write if the agent should publish products, and webhooks:write for webhook management.
Pick your client below and follow the install steps. Every example assumes your key is in the env var OCB_API_KEY.

Tools exposed

search_products

Browse the marketplace with filters, sorting and pagination.

get_product

Fetch detailed info on a product by slug.

get_reviews

Read reviews of a product.

list_my_products

List the products owned by the authenticated creator.

get_analytics

Read sales, views, conversion and revenue KPIs.

list_library

List products the API key owner has purchased.

purchase_product

Buy a product — returns a Stripe Checkout URL.

download_product

Get a presigned download URL for a purchased product (15 min expiry).

create_product

Create a new draft product listing.

Install in your client

Claude Code

CLI

Use the claude mcp add command. The -- separator before the launch command is required; flags must come before it.

claude mcp add openclawbundles \
  --transport stdio \
  --scope user \
  --env OCB_API_KEY=YOUR_OCB_API_KEY \
  -- npx -y @openclawbundles/mcp-server

Scopes: local (current project), project (committed to .mcp.json), user (all your projects). Verify with /mcp inside Claude Code.

Claude Desktop

GUI + JSON

Open Settings → Developer → Edit Config and add the entry below.

macOS = ~/Library/Application Support/Claude/claude_desktop_config.json
Windows = %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openclawbundles": {
      "command": "npx",
      "args": ["-y", "@openclawbundles/mcp-server"],
      "env": {
        "OCB_API_KEY": "YOUR_OCB_API_KEY"
      }
    }
  }
}

Fully quit and relaunch Claude Desktop after editing. On Windows, if you see ENOENT or ${APPDATA} errors, run "npm install -g npm" once and add "APPDATA": "C:\\\\Users\\\\<you>\\\\AppData\\\\Roaming\\\\" inside env.

Cursor

JSON

Edit the MCP config file, or use Cursor Settings → Features → MCP → Add New MCP Server (transport: stdio).

global = ~/.cursor/mcp.json
project = <project>/.cursor/mcp.json

{
  "mcpServers": {
    "openclawbundles": {
      "command": "npx",
      "args": ["-y", "@openclawbundles/mcp-server"],
      "env": {
        "OCB_API_KEY": "${env:OCB_API_KEY}"
      }
    }
  }
}

Reload Cursor after editing the file, then enable the server in the MCP panel.

Gemini CLI

CLI + JSON

Use the gemini mcp add helper, or edit the settings file directly.

global = ~/.gemini/settings.json
project = .gemini/settings.json

gemini mcp add -e OCB_API_KEY=YOUR_OCB_API_KEY \
  openclawbundles npx -y @openclawbundles/mcp-server

{
  "mcpServers": {
    "openclawbundles": {
      "command": "npx",
      "args": ["-y", "@openclawbundles/mcp-server"],
      "env": {
        "OCB_API_KEY": "$OCB_API_KEY"
      },
      "timeout": 30000,
      "trust": false
    }
  }
}

Restart the gemini CLI, then verify with /mcp.

Windsurf

GUI + JSON

Add it from Windsurf Settings → Cascade → MCP Servers, or edit the config file.

macOS / Linux = ~/.codeium/windsurf/mcp_config.json
Windows = %USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "openclawbundles": {
      "command": "npx",
      "args": ["-y", "@openclawbundles/mcp-server"],
      "env": {
        "OCB_API_KEY": "${env:OCB_API_KEY}"
      }
    }
  }
}

Restart Windsurf to load the new server.

Try it out

Once installed, ask your agent natural-language prompts like:

“Search OpenClawBundles for the most popular skill packs about email automation.”
“Show me the 5 best-rated personas under $20 and summarize their reviews.”
“What were my OpenClaw sales for the last 30 days? Break down by product.”
“Find the highest-rated bundle for Stripe webhooks and buy it for me.”
“List my purchased bundles and download the latest version of each.”

Troubleshooting

“Invalid API key” / 401: the key was revoked or never created. Generate a new one at /dashboard/creator/api-keys.
“Missing required scope: purchases:write”: your key was created before the buyer flow shipped, or you didn’t tick that scope. Recreate the key with the scope enabled.
list_library returns an empty array: the key owner hasn’t bought anything yet — try purchase_product first.
Server fails to start with ENOENT: Node.js or npx is not on PATH. Install Node 18+ and reopen the client.
Tools don’t appear after install: fully quit and relaunch the client (Desktop/Cursor/ Windsurf), or run /mcp in CLI clients to inspect server status.

Source & security

The MCP server is open source. Browse it on GitHub or on npm. The server only reads OCB_API_KEY from its environment and forwards requests to https://api.openclawbundles.com — no other secrets, telemetry or background calls.