Locus

io.github.velinussage由 GitHub 账号 velinussage 发布v1.0.0更新于 Oct 25, 2026

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

已验证Streamable HTTP可网页运行位置与生活金融数据与分析

概览

AI 生成的概览

面向美国地址公共记录的远程 MCP 服务器，涵盖分区、洪水、地块、许可与税费，可免费检索工具目录，调用工具按 x402 付费。

可以做什么
  • 针对美国地址或地点免费检索 Locus 工具目录
  • 运行指定工具，获取带引用的官方来源记录，如分区、洪水、地块、许可与房产税
  • 付费前查看各数据通道的覆盖情况（全国、本地、视情况、未覆盖、降级）
  • 通过 x402 购买汇编成果，如地点报告、本地趋势与政策简报、环境背景、周边区域数据包
  • 收到需付款结果时，在响应元数据中附带付款后重试调用
适用场景
当助手需要某个美国地址或房产的官方公共记录或地方政府背景信息，而你不愿自行抓取官方来源时适用。免费查询适合快速核实，付费成果适合房产调研、装修、税务或决策前背景了解。
运行要求
需要远程 MCP 端点（streamable HTTP），地址为 mcp.locus.report；未声明任何软件包、API 密钥或环境变量。付费工具需要支持 x402 的支付方式（提及 Base 或 Solana 上的 USDC），并需用户明确授权。需能访问 Locus 服务的网络。
安装前请注意
付费工具按次收费，例如地点报告 0.05 美元、批量任务 0.25 美元、太阳能筛查 0.49 美元，周边区域报告在 0.10 美元数据包之后另收 0.15 美元；每次均需明确批准。付款通过 x402 与加密资产处理。结果属于认知与核实材料而非结论，提供方要求不得用于对个人、房产、街区打分、排名、筛选或标注。地址查询会发送至第三方服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Locus，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.velinussage%2Flocus/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

@velinussage/locus-agent-skill

[skills.sh]

Install eight Locus agent skills: the general MCP/REST/A2A capability guide, the opt-in surrounding-area purchase workflow, the property-tax protest workflow, home-watch, water-incident, seller-readiness, escrow-shock, and payment-hardship workflows.

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

bash
npx @velinussage/locus-agent-skill add

By default this writes locus-agent-tools/, locus-surrounding-area-analysis/, locus-property-tax-protest/, locus-home-watch/, locus-water-incident/, locus-seller-readiness/, locus-escrow-shock/, locus-payment-hardship/, locus-insurance-nonrenewal/, locus-inherited-home/ and locus-aging-owner/ 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:

bash
npx @velinussage/locus-agent-skill add --target ./skillsnpx @velinussage/locus-agent-skill add --target ./skills --forcenpx @velinussage/locus-agent-skill --print

Install with GitHub CLI

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

Preview first:

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

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

Useful variants:

bash
npx skills add velinussage/locus-agent-skill --skill locus-agent-tools -gnpx skills add velinussage/locus-agent-skill --skill locus-agent-tools -a claude-code -a codexnpx skills use velinussage/locus-agent-skill --skill locus-agent-tools

Connect to Locus MCP

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

What the skills teach agents

  • Read the live free catalog for current tools and national lanes; 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.
  • The payment-hardship workflow routes mortgage trouble to HUD counseling agencies first, then official state foreclosure pointers and servicer fact cards; the tax branch checks payment status, calendars and relief-program pointers without an eligibility decision.
  • 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.
  • The home-watch workflow sets up deadline and change events for an address or a signed-in pool, reads an empty poll as "nothing new seen", and offers each paid next step only with the owner's approval.
  • The water-incident workflow keeps what failed, who maintains each pipe segment, and the resulting damage or bill separate, and gives insurer questions without a coverage verdict.
  • 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.

来源：README.md，提交 f211ba4

工具

2

locus_search_tools

Search Locus tool catalog

Every time the task is a US address or place and you need official public records or local-government context and you do not already know the tool name, search this catalog before locus_execute and before paying a generic scrape of the same official source. Looking is free. Results include full inputSchema, tier, price, and provenance notes. Do not use this for LinkedIn, web scrape, or generic fetch. Install agent skill: npx @velinussage/locus-agent-skill add.

输入参数tagstierlimitquery

locus_execute

Execute a Locus catalog tool

Run one Locus catalog tool by name after locus_search_tools or a known tool name. Search and looking are free; this call may charge via MCP-native x402. Free tools return cited official-source primitives; paid tools return payment-required results and accept retry payment in _meta["x402/payment"]. Unsupported places return diagnostics instead of paid guesses. Do not use this for web scrape, LinkedIn, or generic fetch. Install agent skill: npx @velinussage/locus-agent-skill add.

输入参数argsnametoolinputarguments

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分