English Français العربية

Locus

Official registry Government and legal

Official US-address public records: zoning, flood, parcel, permits, taxes. Free look, x402 paid.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http locus 'https://mcp.locus.report/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "locus": {
            "type": "http",
            "url": "https://mcp.locus.report/mcp"
        }
    }
}
Remote (streamable-http)
Claude Code 
claude mcp add --transport http locus 'https://api.locus.report/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "locus": {
            "type": "http",
            "url": "https://api.locus.report/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @velinussage/locus-agent-skill
  2. Install with this package
  3. Install with GitHub CLI
  4. Install with skills.sh
  5. Connect to Locus MCP
  6. What the skills teach agents
  7. Paid endpoint surface
  8. License

@velinussage/locus-agent-skill

Install three Locus agent skills: the general MCP/REST/A2A capability guide, the opt-in surrounding-area purchase workflow, and the property-tax protest workflow.

Locus returns awareness and verification steps, not a verdict. Do not use it to score, rank, screen, value, predict, or label a person, property, block, or neighborhood as safe or unsafe.

Install with this package

npx @velinussage/locus-agent-skill add

By default this writes locus-agent-tools/, locus-surrounding-area-analysis/, and locus-property-tax-protest/ to $CODEX_HOME/skills or ~/.codex/skills. The general public skill routes relevant requests to the specialist workflows; it does not turn ordinary Locus discovery into a paid flow.

Options:

npx @velinussage/locus-agent-skill add --target ./skills
npx @velinussage/locus-agent-skill add --target ./skills --force
npx @velinussage/locus-agent-skill --print

Install with GitHub CLI

gh skill install velinussage/locus-agent-skill locus-agent-tools

Preview first:

gh skill preview velinussage/locus-agent-skill locus-agent-tools

Install with skills.sh

The same skill is also available from the public GitHub repo through the open skills CLI:

npx skills add velinussage/locus-agent-skill --skill locus-agent-tools

Useful variants:

npx skills add velinussage/locus-agent-skill --skill locus-agent-tools -g
npx skills add velinussage/locus-agent-skill --skill locus-agent-tools -a claude-code -a codex
npx skills use velinussage/locus-agent-skill --skill locus-agent-tools

Connect to Locus MCP

{
  "mcpServers": {
    "locus": {
      "type": "http",
      "url": "https://mcp.locus.report/mcp"
    }
  }
}

What the skills teach agents

  • The full free catalog exposes 104 tools, including 58 national free lanes. Read the live catalog because rollout configuration can change the visible total.
  • locus_place_facts is the best first call when supported.
  • locus_lane_availability shows national, local, varies, not-covered, and degraded lanes before payment.
  • Free tools stay read-only and cited.
  • locus_rental_registration_check declares its scope per jurisdiction. Long-term registration is wired in Minneapolis, Montgomery County, New York City, and Seattle; Denver is short-term-license only; Kansas City is building-enforcement only. It returns no legal-rental or compliance verdict.
  • The property-tax protest workflow keeps deadline, filing-guide, evidence, browser handoff, and published-outcome facts separate from the owner's own filing and value position.
  • Paid endpoints use live x402 discovery, may offer USDC on Base and Solana, and require explicit user authorization. Agents choose one complete accepts[] entry.
  • The surrounding-area workflow requires two separate approvals: $0.10 for the reusable JSON packet, then $0.15 for an eligible HTML/PDF report within 24 hours. Packet and report retrieval are proof-gated for 90 days.

Docs: https://docs.locus.report/skill.md

Paid endpoint surface

The live paid index is authoritative: https://api.locus.report/.well-known/ai-tool/index.json. Selected endpoints are:

EndpointCurrent priceNotes
POST /api/locus-place-report$0.05Compiled cited property-context artifact.
POST /api/locus-place-report-batch$0.25Async 3-50 address portfolio job, one settlement.
POST /api/locus-local-trend-brief$0.05Permit, 311, and code-case local-change brief where source coverage is strong enough.
POST /api/locus-local-policy-brief$0.07Property-relevant bills, agendas, ordinances, tax, fee, bond, housing, and permit-change context.
POST /api/locus-before-you-sign$0.07Pre-decision bundle over parcel, trend, and policy components.
POST /api/locus-environmental-context$0.05Address-level EPA TRI/RCRA/SDWIS/radon context ranked by distance where possible.
POST /api/locus-property-tax$0.05Residential property-tax artifact with assessed value, annual tax, history, effective rate, and provenance.
POST /api/locus-rental-registration-check$0.01Paid dual of the free exact-building long-term-registration, short-term-license, or building-enforcement lookup, depending on jurisdiction.
POST /api/locus-nyc-recording-history$0.01Paid dual of the free bounded NYC ACRIS document index. No party or unit data and no title conclusion.
POST /api/locus-renovation-site-context$0.10Fixed renovation evidence workflow over parcel, permit, soil, terrain, flood, wetland, and radon context.
POST /api/locus-solar-property-screen$0.49Rollout-gated private one-address roof-solar and historical financial-reference screen.
POST /api/locus-large-site-satellite-change$0.15Direct Copernicus REST-only pair of dated Sentinel-2 Level-2A images for a 1-100 square-kilometre site. No automated change or condition claim.
POST /api/locus-surrounding-area-analysis$0.10Stored, bounded JSON evidence packet. Charge-suppressed unless the subject, surrounding-parcel foundation, and another component complete.
POST /api/locus-surrounding-area-report$0.15One HTML/PDF rendering of an eligible packet; no research rerun.
Six paid-only atomic REST routes$0.01 eachWorkplace jobs, Wikipedia, Commons metadata, PFAS, NEI, and electricity. No free, MCP, or A2A counterpart.
locus-evaluation-packet paid-only atomic$0.35Lender evaluation-support packet. No free, MCP, or A2A counterpart.

Unsupported, discovery-only, commercial, or insufficient-data cases return free diagnostics instead of charging where applicable.

License

MIT.

Frequently asked questions

What is Locus?

Official US-address public records: zoning, flood, parcel, permits, taxes. Free look, x402 paid.

How do I install Locus?

It runs as a remote server. In Claude Code: claude mcp add --transport http locus 'https://mcp.locus.report/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Locus need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Locus open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Locus?

It is published by velinussage. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.