Locus

@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:

Endpoint	Current price	Notes
POST /api/locus-place-report	$0.05	Compiled cited property-context artifact.
POST /api/locus-place-report-batch	$0.25	Async 3-50 address portfolio job, one settlement.
POST /api/locus-local-trend-brief	$0.05	Permit, 311, and code-case local-change brief where source coverage is strong enough.
POST /api/locus-local-policy-brief	$0.07	Property-relevant bills, agendas, ordinances, tax, fee, bond, housing, and permit-change context.
POST /api/locus-before-you-sign	$0.07	Pre-decision bundle over parcel, trend, and policy components.
POST /api/locus-environmental-context	$0.05	Address-level EPA TRI/RCRA/SDWIS/radon context ranked by distance where possible.
POST /api/locus-property-tax	$0.05	Residential property-tax artifact with assessed value, annual tax, history, effective rate, and provenance.
POST /api/locus-rental-registration-check	$0.01	Paid 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.01	Paid 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.10	Fixed renovation evidence workflow over parcel, permit, soil, terrain, flood, wetland, and radon context.
POST /api/locus-solar-property-screen	$0.49	Rollout-gated private one-address roof-solar and historical financial-reference screen.
POST /api/locus-large-site-satellite-change	$0.15	Direct 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.10	Stored, bounded JSON evidence packet. Charge-suppressed unless the subject, surrounding-parcel foundation, and another component complete.
POST /api/locus-surrounding-area-report	$0.15	One HTML/PDF rendering of an eligible packet; no research rerun.
Six paid-only atomic REST routes	$0.01 each	Workplace jobs, Wikipedia, Commons metadata, PFAS, NEI, and electricity. No free, MCP, or A2A counterpart.
locus-evaluation-packet paid-only atomic	$0.35	Lender 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.