io.github.FoundryNet/foundrynet-geo
x402-gated geocoding + distance gateway. Tools: geocode, distance.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http foundrynet-geo 'https://foundrynet-geo-production.up.railway.app/mcp'{
"mcpServers": {
"foundrynet-geo": {
"type": "http",
"url": "https://foundrynet-geo-production.up.railway.app/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
FoundryNet Geo — Facility Risk Mapper
Facility location risk assessment — score any address for weather threats, regulatory activity, and operational risk factors. Also provides geocoding and distance calculations. One call, one micropayment — no API keys, no accounts.
Part of the FoundryNet Data Network. Pay-per-call in USDC (x402) or bypass with an fnet_ Forge key. Also exposed as an MCP server so agents on Smithery/Glama/Claude can call it directly.
Tools / Endpoints
| Tool / Route | Price | Description |
|---|---|---|
geocode — POST /v1/geocode | $0.005 | Address → {lat, lng, formatted_address, components}, or {lat,lng} → reverse-geocode |
distance — POST /v1/distance | $0.005 | {from, to} → {distance_km, duration_estimate} |
facility_risk — POST /v1/facility-risk | $0.02 | {address} → {risk_score, risk_level, risk_factors[], coordinates, recommendation} — geocodes the address, then enriches with live weather alerts (and regulatory jurisdiction activity) from sibling FoundryNet servers |
Backends: US Census Geocoder (precise for US addresses) + Nominatim / OpenStreetMap (global) — both free and keyless.
MCP
Streamable HTTP endpoint: https://foundrynet-geo-production.up.railway.app/mcp
claude mcp add --transport http foundrynet-geo https://foundrynet-geo-production.up.railway.app/mcpTools list without auth (discoverable). Pass an fnet_ key as the api_key argument (or Authorization: Bearer) to bypass payment; otherwise the tool returns an x402 payment_required object.
Payment (x402)
Standard x402 v2 on Solana mainnet USDC. Discovery: GET /x402, GET /.well-known/x402, and a per-route 402 at GET /x402/{route} (with the PAYMENT-REQUIRED header). Validated on 402 Index.
For logistics, delivery, and real-estate agents that need geocoding at high frequency and low cost.
Frequently asked questions
What is io.github.FoundryNet/foundrynet-geo?
x402-gated geocoding + distance gateway. Tools: geocode, distance.
How do I install io.github.FoundryNet/foundrynet-geo?
It runs as a remote server. In Claude Code: claude mcp add --transport http foundrynet-geo 'https://foundrynet-geo-production.up.railway.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.FoundryNet/foundrynet-geo need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.FoundryNet/foundrynet-geo open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.FoundryNet/foundrynet-geo?
It is published by FoundryNet. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.