@velinussage/locus-agent-skill

Name: Locus
Author: velinussage

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.