Connect KnowLocal to Claude Desktop, Cursor, or any MCP client

KnowLocal's MCP server lets your AI assistant run audits, read your weekly task, and check your credit balance — using the same account as the website.

Before you start

1. Run a free scan at knowlocal.io and verify your email (creates your account + starter credits). 2. Optional: buy more credits at /credits if you expect PRO scans or weekly tasks.

Step 1 — Mint your API key

1. Open knowlocal.io/connect 2. Enter the same email you used for your scan 3. Enter the 6-digit code from your inbox 4. Copy the kl_live_… key — it is shown once

View your balance and ledger any time at /account.

Step 2 — Claude Desktop

Paste the JSON from /connect into claude_desktop_config.json:

``json { "mcpServers": { "knowlocal": { "url": "https://knowlocal.io/mcp", "headers": { "Authorization": "Bearer kl_live_YOUR_KEY_HERE" } } } } ``

Restart Claude Desktop. You should see knowlocal in the connector list with 15 tools.

Step 3 — Cursor

1. Cursor Settings → MCP → Add server 2. Type: HTTP (Streamable HTTP) 3. URL: https://knowlocal.io/mcp 4. Header: Authorization: Bearer kl_live_YOUR_KEY_HERE

Step 4 — Generic HTTP client

• Endpoint: POST https://knowlocal.io/mcp (JSON-RPC 2.0)
• Optional: GET https://knowlocal.io/mcp with Accept: text/event-stream for the server stream
• Auth: Authorization: Bearer kl_live_…
• Discovery: /.well-known/mcp

First call: initialize → save the Mcp-Session-Id response header for later requests.

Credit costs (metered)

| Action | Credits | |---|---| | Basic scan (web funnel) | 1 | | PRO scan / confirm_business / cache-miss run_audit | 3 | | Weekly task (first fetch each week) | 2 | | get_intelligence, get_report, cached run_audit | 0 |

If a tool returns insufficient_credits, top up at /credits — credits never expire.

Install the KnowLocal Skill (recommended)

Copy skill/knowlocal/SKILL.md from the KnowLocal repo into your assistant's Skills folder so it knows when to call each tool and how to phrase results for a non-technical owner.

Frequently asked questions