API / MCP

BoringBuy for AI agents

A Model Context Protocol endpoint over screened North American businesses for sale: normalised USD financials, cash-flow multiples, red flags and SBA 7(a) loan benchmarks. No CAPTCHA, CORS open, JSON-RPC 2.0 over HTTP.

Endpoint
https://boringbuy.com/api/mcp

Access tiers

TierResults / callFields & toolsLimit
Keyless10Teaser fields, market_stats, basic valuation60 calls / 10 min per IP
Operator key50Full public fields, valuation_check with DSCR, new_since500 calls / mo
Firm key100Everything in Operator + broker contact5,000 calls / mo

A key on the free Browse plan gets keyless-equivalent teaser access.

Tools

Claude Desktop / Cursor config

{
  "mcpServers": {
    "boringbuy": {
      "url": "https://boringbuy.com/api/mcp",
      "headers": { "Authorization": "Bearer bb_..." }
    }
  }
}

Omit the headers block for keyless access.

curl

# initialize
curl -s -X POST https://boringbuy.com/api/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'

# list tools
curl -s -X POST https://boringbuy.com/api/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# search (add -H 'Authorization: Bearer bb_...' for keyed access)
curl -s -X POST https://boringbuy.com/api/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_listings","arguments":{"state":"WA","max_multiple":3,"limit":10}}}'