# Business Change Intelligence

> Temporal, evidence-backed business and location changes for research agents.

## Release status

- Platform contract: v1.0.0
- Initial migration plan: 521 events, 1139 source records, 9 sources
- Initial source geography: Florida; platform model: multi-jurisdiction
- Public data plane: live at https://api.businesschanges.dev
- Payment enforcement: disabled pending an approved recipient wallet

## Discovery

- Documentation: https://www.businesschanges.dev/docs
- Agent manifest: https://www.businesschanges.dev/.well-known/agent-capabilities.json
- OpenAPI: https://www.businesschanges.dev/openapi.json
- Production API: https://api.businesschanges.dev
- Production MCP: https://api.businesschanges.dev/mcp

## Tools

### find_business_change_leads

Discover previously unknown businesses and locations by geography, intent, event time, observation time, evidence, and confidence.

HTTP: `/v1/events/search`
Price: $0.10 proposed

### get_business_event_evidence

Expand only selected event IDs into immutable, dated source records with native identifiers and URLs.

HTTP: `/v1/events/evidence`
Price: $0.02 proposed

### get_location_timeline

Retrieve chronological business changes for an exact premises or an explicitly requested parent building.

HTTP: `/v1/locations/timeline`
Price: $0.03 proposed

### get_changes_since

Consume a stable observed-time delta feed, including corrections, supersessions, and retractions.

HTTP: `/v1/changes`
Price: $0.05 proposed

### get_business_change_coverage

Check supported sources, jurisdictions, collection windows, freshness, failures, and limitations before interpreting results.

HTTP: `/v1/coverage`
Price: Free

## Intents

- `opening_leads`: Early regulatory and location signals for establishments that may be preparing to open.
- `construction_activity`: Permit, plan-review, build-out, expansion, and construction activity at business locations.
- `remodels`: Signals that an existing establishment may be rebuilding, remodeling, or expanding.
- `operator_changes`: Ownership, operator, brand, or tenant transitions tied to a location over time.
- `closure_risk`: Authoritative status, license, inspection, or tenant-transition signals worth investigating.
- `compliance_activity`: License, inspection, enforcement, and regulatory activity for a business or location.

## Required semantics

- The calling agent maps natural language into typed arguments; retrieval is deterministic.
- effectiveAt is event time; firstObservedAt is platform discovery time.
- Exact premises is the default; building aggregation must be explicitly requested.
- Search compact events first and expand evidence only for selected event IDs.
- Regulatory activity does not prove that a business is publicly open or closed.
- A no-match does not imply absence unless relevant source coverage is complete.
- Delta clients must process superseded and retracted events.