MCP syntax

Connect

Transport http · URL https://agent-scaffold-mcp.vercel.app/mcp

The HTTP connection is unauthenticated. Credit-gated tools take apiKey in arguments, not as a bearer token. Or pay 9 USDC on Base with quote_single_use — no account.

claude mcp add --transport http botkelp https://agent-scaffold-mcp.vercel.app/mcp

{
  "mcpServers": {
    "botkelp": {
      "type": "http",
      "url": "https://agent-scaffold-mcp.vercel.app/mcp"
    }
  }
}

Pay without an account

An agent with a web3 wallet can buy one generate. No signup. No apiKey.

USDC on base (chainId 8453) · 9 USDC · payTo 0xb07ce1000000000000000000000000000000b07c

1. Call quote_single_use({ sku: "single-generate" }). No auth.
2. From the wallet, transfer the exact amountAtomic USDC on Base to payTo (eip681 or tx in the quote).
3. Call generate_scaffold with payment: { quoteId, txHash } and your component ids. Omit apiKey.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quote_single_use",
    "arguments": {
      "sku": "single-generate"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_scaffold",
    "arguments": {
      "payment": {
        "quoteId": "00000000-0000-4000-8000-000000000000",
        "txHash": "0xabababababababababababababababababababababababababababababababab"
      },
      "components": [
        "nextjs-base",
        "navbar"
      ],
      "projectName": "my-app",
      "repoName": "my-org/my-app",
      "get_site_profile": true
    }
  }
}

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

Knowledge (account holders only)

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_ask",
    "arguments": {
      "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.
• 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": {}
}

quote_single_usev1.0.0

No auth. Returns a Base USDC quote for one generate without an account. Pay exact amountAtomic to payTo, then call the tool with payment.quoteId and payment.txHash.

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "quote_single_use",
    "arguments": {
      "sku": "single-generate"
    }
  }
}

generate_scaffoldv1.1.0

Copy catalog component files for a stack. Exact pins that do not fit return COMPONENT_VERSION_INCOMPATIBLE — never a silent substitute. Pass get_site_profile: true to attach dashboard legal docs in the same result (not in the tree).

Gated: yes — apiKey required · 10/min · permissions registry.read, component.generate

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_scaffold",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "components": [
        "nextjs-base",
        "navbar"
      ],
      "stack": {
        "nextjs": "16.3.4",
        "react": "19.2.8"
      },
      "projectName": "my-app",
      "repoName": "my-org/my-app",
      "get_site_profile": true
    }
  }
}

get_scaffold_templatev1.0.0

Fetch a scaffold template repo. Costs 100 credits. Admin/legal pages are not in the repo; pass get_site_profile: true to attach dashboard documents in the same result.

Gated: yes — apiKey required · 20/min · permissions registry.read, account.credits

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_scaffold_template",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "get_site_profile": true
    }
  }
}

get_site_profilev1.0.0

Return this account's populated dashboard legal documents as JSON bodies + paths. Follow-up when a generate result has incomplete: true. Never written into tpl repos.

Gated: yes — apiKey required · 30/min · permissions component.generate

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

knowledge_searchv1.0.0

Search the BotKelp catalog knowledge base. Account holders only. Not a web search.

Gated: yes — apiKey required · 30/min · permissions knowledge.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_search",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "query": "supabase auth"
    }
  }
}

knowledge_getv1.0.0

Full knowledge record for a catalog component. Account holders only.

Gated: yes — apiKey required · 30/min · permissions knowledge.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_get",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "name": "supabase-client"
    }
  }
}

knowledge_askv1.0.0

Implementation-ready answer from supplied catalog knowledge. Account holders only.

Gated: yes — apiKey required · 10/min · permissions knowledge.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_ask",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "question": "How do I add authentication to the Next.js + Supabase template?",
      "technology": "Next.js"
    }
  }
}

knowledge_sourcesv1.0.0

Authoritative sources for a catalog item. Account holders only.

Gated: yes — apiKey required · 30/min · permissions knowledge.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_sources",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "name": "supabase-client"
    }
  }
}

knowledge_implementationv1.0.0

How to implement a catalog component for a task. Account holders only.

Gated: yes — apiKey required · 10/min · permissions knowledge.read

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_implementation",
    "arguments": {
      "apiKey": "bk_live_YOUR_KEY",
      "component": "supabase-auth-ui",
      "task": "Add email magic link authentication",
      "project_context": "Next.js 16 App Router"
    }
  }
}

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}$
• Pick at least one component / At most 12 components per generate
• Rate limit: generate_scaffold allows 10 calls per minute
• Replay rejected: request id already used
• Integrity fail — catalog bytes did not match published SHA-256
• Unknown quoteId. Call quote_single_use first.
• No USDC Transfer to the quote payTo for the exact amount on Base
• Quote already used
• Quote expired. Request a new quote_single_use.

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