# Locus

> Locus is an address-first public-records tool for property workflows. It returns cited tax, zoning, flood, environmental, permit, development, transportation, representative, and policy context for a U.S. place. Locus is awareness and verification, not a verdict.

Use this file as the curated starting map. Prefer live catalogs over copied tool lists because coverage, prices, and schemas change. Preserve provenance, caveats, and verify-next steps.

Important boundaries:
- Do not use Locus for tenant screening, lending, insurance, employment, background checks, appraisal, valuation, policing, or safe/unsafe labels.
- An empty source result means that source returned no matching records, not that no records exist.
- Free tools need no account API key. Paid tools require an explicit x402 or advertised MPP payment and user authorization.

## Start here

- [Free catalog](https://api.locus.report/tools/list): schemas for the no-charge tools.
- [Free call](https://api.locus.report/tools/call): `POST {"name":"<tool>","arguments":{...}}`.
- [Agent skill](https://api.locus.report/.well-known/skill.md): operating guide for MCP, A2A, and REST.
- [RFC 9727 API catalog](https://api.locus.report/.well-known/api-catalog): standard discovery document.
- [Longer map](https://api.locus.report/llms-full.txt): extra pointers, still not a pasted inventory.

First free calls:
- `locus_lane_availability`: which lanes and paid tools can return data for this exact address.
- `locus_suggest_workflow`: ranked free/paid plan for a place and intent.
- `locus_place_facts`: one-call snapshot when the parcel lane is wired.

Install the skill:
- `npx skills add velinussage/locus-agent-skill --skill locus-agent-tools`
- `npx @velinussage/locus-agent-skill add`
- `gh skill install velinussage/locus-agent-skill locus-agent-tools`

## Live agent surfaces

- [API discovery index](https://api.locus.report/): cold-agent JSON with a `start` object.
- [OpenAPI](https://api.locus.report/openapi.json): free and paid operations, including calling conventions.
- [Remote MCP](https://mcp.locus.report/mcp): `locus_search_tools` and `locus_execute`.
- [MCP catalog](https://mcp.locus.report/catalog): searchable generated catalog.
- [A2A agent card](https://api.locus.report/.well-known/agent-card.json): A2A skills and message endpoint.
- [Unified catalog](https://api.locus.report/.well-known/locus-tools.json): free and paid schemas, prices, counterparts.
- [Top agent endpoints](https://api.locus.report/.well-known/locus-agent-endpoints.json): bundle-first menu.

## Paid tools

- [Paid index](https://api.locus.report/.well-known/ai-tool/index.json): current prices, endpoints, and manifests.
- Confirm price, chain, recipient, and schema from the live 402 challenge before paying.

## Human docs

- [Web app](https://locus.report): address search, reports, and place following.
- [Docs](https://docs.locus.report): product and agent integration.
- [Agent workflows](https://docs.locus.report/mcp/): discover, preflight, call, pay, and cite.