English Français العربية

io.github.FoundryNet/foundrynet-geo

السجل الرسمي مؤرشف الخرائط والسفر والطقس

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http foundrynet-geo 'https://foundrynet-geo-production.up.railway.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "foundrynet-geo": {
            "type": "http",
            "url": "https://foundrynet-geo-production.up.railway.app/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FoundryNet Geo — Facility Risk Mapper
  2. Tools / Endpoints
  3. MCP
  4. Payment (x402)

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 / RoutePriceDescription
geocode — POST /v1/geocode$0.005Address → {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.

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

الأسئلة الشائعة

ما هو io.github.FoundryNet/foundrynet-geo؟

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

كيف أثبّت io.github.FoundryNet/foundrynet-geo؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http foundrynet-geo 'https://foundrynet-geo-production.up.railway.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.FoundryNet/foundrynet-geo إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.FoundryNet/foundrynet-geo مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.FoundryNet/foundrynet-geo؟

ينشره FoundryNet. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.