Locus
Official US-address public records: zoning, flood, parcel, permits, taxes. Free look, x402 paid.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http locus 'https://mcp.locus.report/mcp'
{
"mcpServers": {
"locus": {
"type": "http",
"url": "https://mcp.locus.report/mcp"
}
}
}
claude mcp add --transport http locus 'https://api.locus.report/mcp'
{
"mcpServers": {
"locus": {
"type": "http",
"url": "https://api.locus.report/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
@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_factsis the best first call when supported.locus_lane_availabilityshows national, local, varies, not-covered, and degraded lanes before payment.- Free tools stay read-only and cited.
locus_rental_registration_checkdeclares 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.
الأسئلة الشائعة
ما هو Locus؟
Official US-address public records: zoning, flood, parcel, permits, taxes. Free look, x402 paid.
كيف أثبّت Locus؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http locus 'https://mcp.locus.report/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Locus إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Locus مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Locus؟
ينشره velinussage. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.