MCP syntax

Connect

Transport http · URL https://www.botkelp.com/mcp

Connect with the URL only (no client ID, secret or key argument). Nothing: initialize, tools/list, get_help, get_account_status. A wallet: purchase_scaffold via x402 (no Authorization header -> HTTP 402 -> retry with _meta["x402/payment"]). An account: every other tool; sign in when prompted (MCP OAuth 2.1) or send Authorization: Bearer bk_live_…. A 401 means "needs an account". Never pass account_api_key as a tool argument. verify_scaffold needs an account plus projectid.

claude mcp add --transport http botkelp https://www.botkelp.com/mcp

{
  "mcpServers": {
    "botkelp": {
      "type": "http",
      "url": "https://www.botkelp.com/mcp"
    }
  }
}

Client Auth Matrix (OAuth vs Bearer)

BotKelp supports both MCP OAuth 2.1 and first-class Bearer tokens (bk_live_…) interchangeably at the transport layer.

Pay without an account

An agent with a web3 wallet can buy a scaffold repo via purchase_scaffold without a linked BotKelp account (x402). No signup.

USDC on base (chainId 8453) · USDC · payTo

1. Call purchase_scaffold with component ids and no payment to get price / accepts
2. Retry the same call with _meta["x402/payment"] set to a matching signed payment
3. You are charged only if the call succeeds

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "purchase_scaffold",
    "arguments": {
      "components": [
        "nextjs-base",
        "navbar"
      ],
      "project": {
        "name": "my-app"
      }
    }
  }
}

Live amounts and address: /pay.json · /pay. Confirm payTo before sending.

Knowledge (HTTP, not MCP)

These names are not MCP tools. They are account-holder HTTP endpoints. Do not send them to tools/call.

Not a web search. Structured answers from the supplied catalog only. Requires bk_live_ and is rate limited.

• knowledge_search 30/min
• knowledge_get 30/min
• knowledge_ask 10/min
• knowledge_sources 30/min
• knowledge_implementation 10/min

{
  "apiKey": "bk_live_YOUR_KEY",
  "question": "How do I add authentication to the Next.js + Supabase template?",
  "technology": "Next.js"
}

HTTP: POST /api/knowledge/knowledge_ask with the same JSON. Signed-in UI: /knowledge.

JSON-RPC methods

• initialize — Handshake. Client sends protocolVersion and capabilities.
• tools/list — Returns the tool names, descriptions, and inputSchema. This is the live list — /tools.json must match it.
• tools/call — Run one tool. params.name is the tool, params.arguments is the object below.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

get_helpv1.0.0

No API key. Plain text: short usage instructions, a one-line-per-tool summary, then the full component catalog as TSV (id, name, version, description, provides, requires, conflictsWith). Call this first. Also readable as the resource botkelp://catalog with no tool call.

Gated: no · 100/min · permissions registry.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_help",
    "arguments": {}
  }
}

get_componentv1.0.0

Returns the exact, unrendered source files for one catalog component. Use this to inspect or compare a component before buying a scaffold. Free, rate-limited to 32 calls/day per account. Requires a linked account (transport auth).

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 30/min · permissions registry.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_component",
    "arguments": {
      "component": "supabase-client"
    }
  }
}

purchase_scaffoldv1.0.0

Requests a build for the given component ids, backed by a private GitHub repo BotKelp owns and manages itself. Extra pages (site_profile, template_files from a connected GitHub repo) bake into a personal clone. Returns a clone credential and a persistent projectid. Pay with linked account credits (transport auth) or via x402.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 10/min · permissions registry.read, account.credits, template.buy

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "purchase_scaffold",
    "arguments": {
      "components": [
        "nextjs-base",
        "navbar"
      ],
      "project": {
        "name": "my-app"
      },
      "site_profile": true
    }
  }
}

get_scaffoldv1.0.0

Re-fetches a scaffold you already purchased via purchase_scaffold: a fresh clone credential and current component versions, at no additional credit cost. Requires an active Maintain subscription for a credit-flow project. delivery: "inline" returns the files in the reply instead of a clone command.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 10/min · permissions registry.read, account.credits

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_scaffold",
    "arguments": {
      "projectid": "proj_…"
    }
  }
}

get_projectsv1.0.0

Lists this account's saved scaffold projects (id, name, description, repo, components, maintain state).

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 30/min · permissions project.write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_projects",
    "arguments": {}
  }
}

set_projectsv1.0.0

Turns Maintain on/off for one of this account's projects and/or rotates its project key. Identify the project with projectid (scoped to your authenticated account).

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 20/min · permissions project.write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_projects",
    "arguments": {
      "projectid": "proj_…",
      "maintain": false
    }
  }
}

get_siteprofilev1.0.0

Returns one or all of this account's named site profiles (privacy, terms, cookies, licence, custom_field) as JSON bodies + destination paths — not as files in a template repo.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 30/min · permissions component.generate

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_siteprofile",
    "arguments": {
      "siteprofilename": "default"
    }
  }
}

set_siteprofilev1.0.0

Creates or updates one named site profile for this account. Fields omitted keep their current saved value. An account may keep more than one named profile.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 20/min · permissions component.generate

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_siteprofile",
    "arguments": {
      "siteprofilename": "acme-co",
      "field": {
        "privacy": "Our privacy policy text."
      }
    }
  }
}

get_githubv1.0.0

Shows whether this account has a GitHub repo connected, or lists files under a path. If not connected, includes installUrl so the user can grant read access (GitHub App). Prefer signing in with GitHub on botkelp.com first.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 30/min · permissions project.write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_github",
    "arguments": {}
  }
}

set_githubv1.0.0

Returns a GitHub App install URL so the user can grant BotKelp read access to one repo. disconnect: true drops the connection. Then purchase_scaffold template_files: [{ source: "app/legal/" }] copies those pages into the clone.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 20/min · permissions project.write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_github",
    "arguments": {}
  }
}

get_adminpagesetv1.0.0

Lists this account's admin page set names (omit name), or returns one set's exact files (pass name). These are extra file trees purchase_scaffold bakes into a unique personal repo.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 30/min · permissions component.generate

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_adminpageset",
    "arguments": {
      "name": "default"
    }
  }
}

set_adminpagesetv1.0.0

Creates or fully replaces one named admin page set for this account — real file source, not text config. An account may keep more than one named set.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 20/min · permissions component.generate

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_adminpageset",
    "arguments": {
      "name": "acme-admin",
      "files": [
        {
          "path": "app/admin/page.tsx",
          "content": "export default function AdminPage() { return <main><h1>Admin</h1></main>; }"
        }
      ]
    }
  }
}

verify_scaffoldv1.0.0

Runs a real `npm install && npm run build` against the given files on an isolated runner and reports whether the project builds. Two-call protocol: pass files to start (returns WAIT + jobId), then call again with jobId to get OK/FAIL. No credit cost, but requires the projectid of a project this account purchased. Use it after editing a get_scaffold result.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 10/min · permissions verify.run

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "verify_scaffold",
    "arguments": {
      "projectid": "proj_…",
      "files": [
        {
          "path": "package.json",
          "content": "{ \"name\": \"my-app\", \"scripts\": { \"build\": \"next build\" } }"
        }
      ],
      "envVariables": [
        "NEXT_PUBLIC_SUPABASE_URL"
      ]
    }
  }
}

report_issuev1.0.0

File a GitHub issue on https://github.com/botkelp/components/issues about generated or catalog code, or request a new component/docs change. Requires a linked account (spam guard), rate-limited to 10 calls/day per account.

Gated: yes — MCP OAuth 2.1 / Bearer bk_live_ · 10/min · permissions issue.write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "report_issue",
    "arguments": {
      "description": "Generated app/layout.tsx has <html> with no lang attribute. Next.js requires html as the root."
    }
  }
}

get_account_statusv1.0.0

Reports whether your authenticated account has a BotKelp account_api_key linked (yes/no) and when it was last linked/rotated. Never returns the key. Call after OAuth.

Gated: no · 60/min · permissions registry.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_account_status",
    "arguments": {}
  }
}

Result

MCP wraps the payload as text content. Parse the JSON. kind is data. instructions is false.

{
  "content": [
    {
      "type": "text",
      "text": "<JSON string of the payload>"
    }
  ],
  "isError": false
}

{
  "kind": "data",
  "instructions": false,
  "source": "botkelp-catalog",
  "verified": true,
  "requestId": "uuid",
  "integrity": {
    "verdict": "pass"
  },
  "files": [
    {
      "destination": "app/layout.tsx",
      "content": "…"
    }
  ]
}

Errors

• Unknown component: {id} — id is not in /catalog.json
• Invalid component id — must match ^[a-z][a-z0-9-]{0,63}$
• COMPONENT_VERSION_INCOMPATIBLE — exact pin does not fit stack; alternatives returned, no silent substitute
• get_component: daily limit of 32 reached for this account
• report_issue: daily limit of 10 reached for this account
• MaintainRequiredError — a repeat get_scaffold/purchase_scaffold for a combination this account already has needs an active Maintain subscription (set_projects)
• Integrity fail — catalog bytes did not match published SHA-256

Component ids: /catalog.json. Machine copy of this page: /mcp.md. Schema hashes: /tools.json. Connect steps: Install.