# foundrynet-geo [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/FoundryNet/foundrynet-geo  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/foundrynet-geo

## Description
x402-gated geocoding + distance gateway. Tools: geocode, distance.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "foundrynet-geo": {
    "url": "https://foundrynet.io?utm_source=github&utm_medium=readme&utm_campaign=foundrynet-geo"
  }
}
```

## Documentation & README

# 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](https://foundrynet.io?utm_source=github&utm_medium=readme&utm_campaign=foundrynet-geo). 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/mcp
```

Tools 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](https://402index.io).

For logistics, delivery, and real-estate agents that need geocoding at high frequency and low cost.