API and MCP

The web app, the REST API and the MCP server share one service layer, so a report looks the same everywhere. Errors follow RFC 7807 (application/problem+json).

New here? Read how to use Place Check

Get an API key

Sign in (Google, Microsoft, GitHub or an e-mail link). New accounts get 1 free credit.
In the dashboard, create a key and copy it (lb_live_…, shown once).
Send it as Authorization: Bearer lb_live_… (REST and MCP) or X-API-Key: lb_live_… (REST).

Creating a report costs 1 credit, refunded automatically when the report fails entirely; without credits the API answers 402 and MCP a tool error. Anonymous copies and reading reports are free. GET /api/v1/reports/{id} is public, like the web link. Each key allows 30 requests per minute (429 beyond).

Connect an AI client over MCP

Streamable HTTP endpoint https://www.place-check.com/api/mcp, authenticated with your API key as a Bearer header (401 without it). Tools: search_address, create_report, get_report, get_balance; they act as the key's account.

Claude Code

claude mcp add --transport http lagebericht https://www.place-check.com/api/mcp \
  --header "Authorization: Bearer lb_live_YOUR_KEY"

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "lagebericht": {
      "url": "https://www.place-check.com/api/mcp",
      "headers": {
        "Authorization": "Bearer lb_live_YOUR_KEY"
      }
    }
  }
}

VS Code (.vscode/mcp.json, asks for the key once)

{
  "inputs": [
    {
      "type": "promptString",
      "id": "lagebericht-key",
      "description": "Lagebericht API key (lb_live_...)",
      "password": true
    }
  ],
  "servers": {
    "lagebericht": {
      "type": "http",
      "url": "https://www.place-check.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:lagebericht-key}"
      }
    }
  }
}

REST quick start

Search an address

curl "https://www.place-check.com/api/v1/addresses?q=Herrengasse%2016%20Graz" \
  -H "Authorization: Bearer $LB_KEY"

Create a report (1 credit)

curl -X POST https://www.place-check.com/api/v1/reports \
  -H "Authorization: Bearer $LB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"Herrengasse 16, 8010 Graz","language":"de"}'

Fetch it again (public)

curl https://www.place-check.com/api/v1/reports/r_xxxxxxxxxx

Credit balance

curl https://www.place-check.com/api/v1/balance -H "Authorization: Bearer $LB_KEY"

OpenAPI 3.1: /api/v1/openapi.json