StreetProof Physical Brand Index™ (PBI)

Public MCP server

Evidence-firstPrivacy-scrubbedMachine-readable

StreetProof exposes the public REST evidence contract as six read-only MCP tools. The server publishes the same versioned fictional fixtures used by the REST documentation, with an output schema for every tool.

MCP server — available now in public beta.

Endpoint:   https://streetproof.com/mcp
Transport:  Streamable HTTP
Auth:       none for public tools; optional StreetProof bearer key
Limit:      60 requests/minute + burst 20 per IP

Versioned contract: /mcp/contract.json. Canonical examples: /api-examples.json.

Matches are city-specific Presence Records. Reviewed brand, organization, and scope relationships appear under identity_hierarchy; automated suggestions are never exposed to MCP consumers.

Illustrative data only

Every record in this file is fictional and illustrative. Example identifiers never resolve to production records.

Lifecycle

Schema version: 2026-08-07.v11
Fixture version: 2026-08-07.v6
Status: public_beta
The live contract includes the deployed Git revision and the canonical fixture SHA-256.

Setup

Claude Desktop / Claude Code

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

Generic MCP clients

curl -X POST https://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":"example-client","version":"1.0"}}}'

Validated tool examples

get_physical_presence

Look up the best matching Presence Record and its current PPS context.

illustrative input

{
  "business_name": "Northstar Bicycle Repair",
  "city": "example-city"
}

output schema

{
  "type": "object",
  "required": [
    "found"
  ],
  "properties": {
    "found": {
      "type": "boolean"
    },
    "match": {
      "type": "object"
    },
    "presence_score": {
      "type": "object"
    },
    "example_only": {
      "type": "boolean"
    }
  }
}

validated illustrative result

{
  "found": true,
  "example_only": true,
  "match": {
    "public_id": "example_entity_001",
    "name": "Northstar Bicycle Repair",
    "city": "Example City",
    "record_type": "presence_record",
    "identity_hierarchy": {
      "review_state": "reviewed",
      "scope": {
        "value": "local_independent",
        "review_state": "reviewed",
        "methodology_version": "entity-scope-v2"
      },
      "brand": {
        "public_id": "brand_example_001",
        "name": "Northstar Bicycle Repair",
        "canonical_domain": "northstar.example"
      },
      "organizations": [
        {
          "relationship_type": "operating_organization",
          "public_id": "org_example_001",
          "name": "Northstar Example Cooperative",
          "organization_type": "company",
          "canonical_domain": "northstar.example"
        }
      ],
      "note": "Only reviewed identity relationships are published."
    }
  },
  "presence_score": {
    "pps": null,
    "cohort_percentile": null
  }
}

compare_presence

Compare two to ten named businesses in one city without treating missing evidence as absence.

illustrative input

{
  "business_names": [
    "Northstar Bicycle Repair",
    "Cedar & Finch Bakery"
  ],
  "city": "example-city"
}

output schema

{
  "type": "object",
  "required": [
    "city",
    "comparison"
  ],
  "properties": {
    "city": {
      "type": "string"
    },
    "comparison": {
      "type": "array"
    },
    "example_only": {
      "type": "boolean"
    }
  }
}

validated illustrative result

{
  "city": "example-city",
  "example_only": true,
  "comparison": [
    {
      "query": "Northstar Bicycle Repair",
      "found": true,
      "match": {
        "record_type": "presence_record",
        "identity_hierarchy": {
          "review_state": "reviewed",
          "scope": {
            "value": "local_independent",
            "review_state": "reviewed",
            "methodology_version": "entity-scope-v2"
          },
          "brand": {
            "public_id": "brand_example_001",
            "name": "Northstar Bicycle Repair",
            "canonical_domain": "northstar.example"
          },
          "organizations": [],
          "note": "Only reviewed identity relationships are published."
        }
      }
    },
    {
      "query": "Cedar & Finch Bakery",
      "found": false
    }
  ]
}

city_index

Page through one frozen city-index snapshot with fixed filters and exact totals.

illustrative input

{
  "city": "example-city",
  "limit": 100
}

output schema

{
  "type": "object",
  "required": [
    "returned_count",
    "total_count",
    "has_more",
    "rankings"
  ],
  "properties": {
    "returned_count": {
      "type": "integer"
    },
    "total_count": {
      "type": "integer"
    },
    "has_more": {
      "type": "boolean"
    },
    "ranking_summary": {
      "type": "object"
    },
    "coverage_context": {
      "type": "object"
    },
    "rankings": {
      "type": "array"
    },
    "example_only": {
      "type": "boolean"
    }
  }
}

validated illustrative result

{
  "example_only": true,
  "returned_count": 1,
  "total_count": 1,
  "has_more": false,
  "next_cursor": null,
  "ranking_summary": {
    "eligible": 0,
    "evidence_building": 1,
    "integrity_review": 0
  },
  "coverage_context": {
    "tier": "building",
    "coverage_basis": "eligible_cell_ratio",
    "eligible_cell_manifest_id": "22222222-2222-4222-8222-222222222222",
    "denominator_status": "reviewed",
    "metrics": {
      "eligible_coverage_cells": 6348,
      "observed_eligible_cells_90d": 36,
      "cell_coverage_ratio_90d": 0.00567,
      "independent_scout_observers_180d": 1
    },
    "dense_gate": {
      "eligible": false,
      "available": true,
      "missing_requirements": [
        "eligible_cell_coverage",
        "independent_scouts"
      ]
    }
  },
  "rankings": [
    {
      "public_id": "example_entity_001",
      "name": "Northstar Bicycle Repair",
      "rank": null,
      "ranking_gate": {
        "status": "evidence_building",
        "methodology_version": "2026-07-30.v3",
        "independent_observers": {
          "current": 1,
          "required": 3,
          "met": false
        },
        "countable_observations": {
          "current": 1,
          "required": 5,
          "met": false
        },
        "observation_days": {
          "current": 1,
          "required": 2,
          "met": false
        },
        "industry_classification": {
          "industry": "bicycle-repair",
          "state": "review",
          "method": "name_rule",
          "authoritative_for_ranking": false
        },
        "missing_requirements": [
          "independent_observers",
          "independent_observations",
          "observation_days",
          "industry_classification_review"
        ]
      },
      "record_type": "presence_record",
      "identity_hierarchy": {
        "review_state": "reviewed",
        "scope": {
          "value": "local_independent",
          "review_state": "reviewed",
          "methodology_version": "entity-scope-v2"
        },
        "brand": {
          "public_id": "brand_example_001",
          "name": "Northstar Bicycle Repair",
          "canonical_domain": "northstar.example"
        },
        "organizations": [],
        "note": "Only reviewed identity relationships are published."
      }
    }
  ]
}

check_physical_evidence

Return an evidence verdict, limitations, and a ready-to-quote citation.

illustrative input

{
  "business_name": "Northstar Bicycle Repair",
  "city": "example-city"
}

output schema

{
  "type": "object",
  "required": [
    "verdict",
    "summary",
    "citation"
  ],
  "properties": {
    "verdict": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "citation": {
      "type": "string"
    },
    "example_only": {
      "type": "boolean"
    }
  }
}

validated illustrative result

{
  "verdict": "physical_citations_found",
  "summary": "Northstar Bicycle Repair is a fictional example with one illustrative physical citation.",
  "citation": "StreetProof Physical Brand Index, as of 2026-01-15, https://streetproof.com/entity/example_entity_001",
  "entity": {
    "record_type": "presence_record",
    "identity_hierarchy": {
      "review_state": "reviewed",
      "scope": {
        "value": "local_independent",
        "review_state": "reviewed",
        "methodology_version": "entity-scope-v2"
      },
      "brand": {
        "public_id": "brand_example_001",
        "name": "Northstar Bicycle Repair",
        "canonical_domain": "northstar.example"
      },
      "organizations": [],
      "note": "Only reviewed identity relationships are published."
    }
  },
  "example_only": true
}

check_business_reality

Deprecated alias for check_physical_evidence. StreetProof reports accepted physical evidence; it does not determine general business legitimacy. Scheduled for removal after 2026-10-27.

illustrative input

{
  "name_or_address": "Northstar Bicycle Repair",
  "city": "example-city"
}

output schema

{
  "type": "object",
  "required": [
    "verdict",
    "deprecated"
  ],
  "properties": {
    "verdict": {
      "type": "string"
    },
    "deprecated": {
      "type": "object"
    },
    "example_only": {
      "type": "boolean"
    }
  }
}

validated illustrative result

{
  "verdict": "physically_observed",
  "deprecated": {
    "replacement": "check_physical_evidence",
    "removal_after": "2026-10-27"
  },
  "entity": {
    "record_type": "presence_record",
    "identity_hierarchy": {
      "review_state": "reviewed",
      "scope": {
        "value": "local_independent",
        "review_state": "reviewed",
        "methodology_version": "entity-scope-v2"
      },
      "brand": {
        "public_id": "brand_example_001",
        "name": "Northstar Bicycle Repair",
        "canonical_domain": "northstar.example"
      },
      "organizations": [],
      "note": "Only reviewed identity relationships are published."
    }
  },
  "example_only": true
}

get_pulse

Read StreetPulse change events for a city from a supplied ISO date.

illustrative input

{
  "city": "example-city",
  "since": "2026-01-01"
}

output schema

{
  "type": "object",
  "required": [
    "city",
    "events"
  ],
  "properties": {
    "city": {},
    "events": {
      "type": "array"
    },
    "example_only": {
      "type": "boolean"
    }
  }
}

validated illustrative result

{
  "city": "example-city",
  "events": [],
  "example_only": true
}

Result semantics

No accepted StreetProof citation matched the request. It never proves absence, closure, inactivity, or that a business is unreal, regardless of coverage tier.
A matched fixed-location asset was observed at that place. This does not establish ownership, tenancy, licensing, or continued operation.
A matched branded mobile asset was observed. This does not establish its owner, home base, operating address, or route.
Branding was visible in the observation. This does not establish ownership, operation, affiliation, or endorsement at that place.
Quote the citation field returned by check_physical_evidence.
Aggregate statistics expressly marked open are CC BY 4.0. Entity records and evidence remain governed by the StreetProof Terms.