Locus

io.github.velinussagePublished by GitHub account velinussagev1.0.0Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server for US-address public records — zoning, flood, parcel, permits and taxes — with a free catalog search and paid x402 tool calls.

What you can do
  • Search a live catalog of Locus tools for a US address or place, free of charge
  • Run a named catalog tool to retrieve cited official-source records such as zoning, flood, parcel, permits and property tax
  • Check lane availability (national, local, varies, not covered, degraded) before paying
  • Pay for compiled artifacts such as place reports, local trend and policy briefs, environmental context and surrounding-area packets via x402
  • Retry a paid call with payment supplied in the response metadata when a payment-required result comes back
When to use it
Useful when an assistant needs official public records or local-government context for a specific US address or property, and you would rather query a curated catalog than scrape official sources yourself. Free lookups suit quick verification; paid artifacts suit property research, renovation, tax or pre-decision context.
Requirements
A remote MCP endpoint (streamable HTTP) at mcp.locus.report; no package, API key or environment variable is declared. Paid tools require an x402-capable payment method, with USDC on Base or Solana mentioned, and explicit user authorization. Network access to the Locus service is needed.
Before you install
Paid tools charge money per call, for example $0.05 for a place report, $0.25 for a batch job, $0.49 for a solar screen and $0.15 for a surrounding-area report after a $0.10 packet; each requires explicit approval. Payment details are handled through x402 and crypto assets. Results are awareness and verification material, not verdicts, and the provider says not to use them to score, rank, screen or label people or properties. Address queries go to a third-party service.

Installation

In SourceWeft

  1. Open Locus in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.velinussage%2Flocus/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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.

Source: README.md at commit f211ba4

Tools

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.

Parameterstagstierlimitquery

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.

Parametersargsnametoolinputarguments

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts