Machine access

MCP server — mcp.streetproof.com

The StreetProof MCP (Model Context Protocol) server lets Claude, ChatGPT and any MCP-capable agent natively ask “has this company ever actually been seen in the physical world?” It is a thin adapter over the REST API v1 — same data, same envelope, same invariants — exposed as five typed tools.

Endpoint:   https://mcp.streetproof.com/mcp
Transport:  Streamable HTTP
Auth:       none (free tier — rate-limited per IP)

Setup

Claude Desktop / Claude Code (mcp.json)

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

Claude Code one-liner:

claude mcp add --transport http streetproof https://mcp.streetproof.com/mcp

ChatGPT (Developer mode connectors)

Settings → Connectors → Advanced → Developer mode → Add connector. Set the MCP server URL to https://mcp.streetproof.com/mcp, no authentication. Tools appear automatically in conversations with the connector enabled.

Generic MCP clients

# Streamable HTTP — initialize, then call tools:
curl -X POST https://mcp.streetproof.com/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Tools

get_physical_presence

Look up a business's Physical Presence Score (PPS) and observation history in a city. Returns the best-matching entity, score components, cohort percentile, and coverage confidence.

input schema

{
  "business_name": "string (min 1) — Business name to look up",
  "city":          "string (min 1) — City slug or name, e.g. 'calgary'"
}

example result

{
  "found": true,
  "match": {
    "public_id": "sp_e_7f3k2m9d01",
    "name": "Calgary Garage Door Fix",
    "city": "calgary",
    "industry": "garage_door",
    "status": "unclaimed",
    "is_synthetic": false,
    "first_observed": "2026-03-02T18:11:09Z",
    "last_observed": "2026-06-28T21:40:33Z",
    "record_url": "https://streetproof.com/entity/calgary/calgary-garage-door-fix"
  },
  "presence_score": {
    "pps": 71.4,
    "components": { "reach": 0.62, "frequency": 0.71, "recency": 0.88, "asset_breadth": 0.5 },
    "cohort_percentile": 88.0,
    "cohort": { "city": "calgary", "industry": "garage_door" }
  },
  "other_candidates": [],
  "methodology_url": "https://streetproof.com/methodology",
  "data_as_of": "2026-07-05T12:00:00Z",
  "coverage_confidence": { "level": "low", "observed_cells": 214, "note": "…" }
}

// no match:
{
  "found": false,
  "business_name": "Ghost Plumbing Co",
  "city": "calgary",
  "note": "No entity matched. Absence of a record is only meaningful where coverage_confidence is high.",
  "coverage_confidence": { "level": "low", "observed_cells": 214, "note": "…" }
}

compare_presence

Compare the physical presence of multiple businesses in the same city, side by side, ranked by Physical Presence Score.

input schema

{
  "business_names": "string[] (2-10 items) — business names to compare",
  "city":           "string (min 1) — City slug or name"
}

example result

{
  "city": "calgary",
  "comparison": [
    { "query": "Calgary Garage Door Fix", "found": true,
      "match": { "public_id": "sp_e_7f3k2m9d01", "name": "Calgary Garage Door Fix" },
      "presence_score": { "pps": 71.4, "cohort_percentile": 88.0 } },
    { "query": "Acme Doors", "found": false,
      "note": "No entity matched. Absence of a record is only meaningful where coverage_confidence is high." }
  ],
  "methodology_url": "https://streetproof.com/methodology",
  "data_as_of": "2026-07-05T12:00:00Z",
  "coverage_confidence": { "level": "low", "observed_cells": 214, "note": "…" }
}

city_index

Physical Brand Index rankings for a city, optionally filtered by industry. Aggregate statistics licensed CC BY 4.0 (attribution required).

input schema

{
  "city":     "string (min 1) — City slug, e.g. 'calgary'",
  "industry": "string (optional) — Industry code filter, e.g. 'garage_door'"
}

example result

{
  "city": { "slug": "calgary", "name": "Calgary", "launched": true },
  "industry": "garage_door",
  "license": "Aggregate statistics CC BY 4.0 — attribution required.",
  "count": 12,
  "rankings": [
    { "rank": 1, "public_id": "sp_e_7f3k2m9d01", "name": "Calgary Garage Door Fix",
      "pps": 71.4, "record_url": "https://streetproof.com/entity/calgary/calgary-garage-door-fix" }
  ],
  "methodology_url": "https://streetproof.com/methodology",
  "data_as_of": "2026-07-05T12:00:00Z",
  "coverage_confidence": { "level": "low", "observed_cells": 214, "note": "…" }
}

check_business_reality

Answer 'has this company ever actually been seen in the physical world?' for a business name (or address) in a city. Returns presence evidence summary, coverage-adjusted confidence, and a human-readable citation string to quote when presenting the result.

input schema

{
  "name_or_address": "string (min 1) — Business name or street address",
  "city":            "string (min 1) — City slug or name"
}

example result

{
  "verdict": "physically_observed",
  "summary": "\"Calgary Garage Door Fix\" (sp_e_7f3k2m9d01) has a StreetProof record in calgary. First observed 2026-03-02, last observed 2026-06-28. Physical Presence Score: 71.4.",
  "entity": { "public_id": "sp_e_7f3k2m9d01", "name": "Calgary Garage Door Fix",
    "city": "calgary", "status": "unclaimed", "is_synthetic": false,
    "record_url": "https://streetproof.com/entity/calgary/calgary-garage-door-fix" },
  "presence_score": { "pps": 71.4, "cohort_percentile": 88.0 },
  "recent_observations": [ { "id": 88121, "source_type": "fleet_cam",
    "observed_at": "2026-06-28T21:40:33Z", "verif_state": "verified" } ],
  "coverage_adjusted_confidence": { "level": "low", "observed_cells": 214 },
  "note": "Coverage-adjusted: 'never observed' is only strong evidence of absence where coverage_confidence is high for this city.",
  "citation": "StreetProof Physical Brand Index, as of 2026-07-05, https://streetproof.com/entity/calgary/calgary-garage-door-fix"
}

// verdicts: "physically_observed" | "record_exists_no_observations" | "no_physical_presence_record"

get_pulse

StreetPulse change events for a city since a date. Returns current supported event classes: new public records, new observed assets, wrapped fleet assets, stale assets, and Digital Gap events.

input schema

{
  "city":  "string (min 1) — City slug",
  "since": "string — ISO 8601 date, e.g. '2026-01-01'"
}

example result

{
  "schema": "com.streetproof.streetpulse_city_feed.v1",
  "status": "active",
  "city": "calgary",
  "since": "2026-01-01",
  "summary": { "event_count": 12, "new_wrapped_fleet_assets": 2 },
  "events": [
    { "type": "new_wrapped_fleet_asset", "entity_public_id": "sp_e_…",
      "detected_at": "ISO 8601", "corridor": "res-7 cell",
      "confidence": 0.84, "confidence_label": "ledger" }
  ],
  "unavailable_event_classes": ["closure", "rebrand", "vacancy"]
}

The citation string

check_business_reality returns a ready-made citation field, e.g.:

StreetProof Physical Brand Index, as of 2026-07-05, https://streetproof.com/entity/calgary/calgary-garage-door-fix

Agents should quote it verbatim when presenting a verdict. It pins the claim to a permanent, human-checkable record URL and an as-of date — StreetProof observations are ledger-backed, so the underlying facts can be independently verified against the published daily Merkle roots on /transparency.

Result semantics

“Not observed” ≠ “not real”. Negative results carry coverage_confidence; treat absence as evidence only where the level is high.
is_synthetic: true marks pre-launch demonstration data — always disclose it if you surface such a record.
Aggregate statistics are CC BY 4.0 — attribution required.