English Français العربية

io.github.mobileappbyharis/navi-x402-mcp

السجل الرسمي المالية والمدفوعات

Paid agent tools, zero API keys: crypto, weather, translation, web intel, x402 discovery (USDC/Base)

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

التثبيت

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

NPM package navi-x402-mcp
Claude Code 
claude mcp add navi-x402-mcp -e 'X402_PRIVATE_KEY=<your x402_private_key>' -e 'MAX_PRICE_USDC=<MAX_PRICE_USDC>' -- npx -y navi-x402-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "navi-x402-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "navi-x402-mcp@1.0.1"
            ],
            "env": {
                "X402_PRIVATE_KEY": "<your x402_private_key>",
                "MAX_PRICE_USDC": "<MAX_PRICE_USDC>"
            }
        }
    }
}

متغيرات البيئة

  • X402_PRIVATE_KEY إلزامي سري Private key of the paying wallet (USDC on Base mainnet). Signs x402 payment authorizations locally.
  • MAX_PRICE_USDC Per-call price ceiling in USDC (default 0.05).

التوثيق

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

المحتويات
  1. navi-x402-mcp
  2. Setup
  3. Tools
  4. Safety
  5. Env reference

navi-x402-mcp

MCP server that gives your AI agent paid superpowers with zero API keys: live crypto prices, weather + air quality, translation, AI market reports, web page intelligence, Google Sheets reading, URL previews — and navi_x402_scout, which finds the best x402 service in the ecosystem for any task.

Every call is paid per-request in USDC on Base via the x402 protocol (prices: $0.001–$0.02). No accounts, no API keys, no subscriptions: your agent's wallet pays only for what it uses.

Setup

  1. Fund a wallet with a few USDC on Base mainnet (a dollar goes a long way).
  2. Add to your MCP client config (Claude Desktop, Cursor, etc.):
{
  "mcpServers": {
    "navi-x402": {
      "command": "npx",
      "args": ["-y", "navi-x402-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0x<private key of the paying wallet>",
        "MAX_PRICE_USDC": "0.05"
      }
    }
  }
}

Tools

Tools are generated dynamically from the live Navi catalog — new endpoints appear automatically. Current highlights:

ToolWhat it doesPrice
navi_x402_scoutTop-3 x402 services for a task, ranked by real 30-day usage$0.005
navi_crypto_pricesLive prices, 7d/30d change, ATH context (CoinGecko)$0.001
navi_market_reportStructured AI crypto market analysis$0.02
navi_weatherForecast + air quality for any location$0.001
navi_translateTranslation with BCP-47 normalization + formality$0.005
navi_web_intelligenceAI page analysis: summary, entities, sentiment$0.005
navi_page_contextPage structure, link taxonomy, repo metadata$0.005
navi_google_sheetsRead any shared Google Sheet as typed JSON$0.003
navi_url_previewOpenGraph/Twitter card metadata$0.001
navi_timestampTimezone-aware time with DST/week signals$0.001

Safety

  • MAX_PRICE_USDC (default 0.05) hard-caps the per-call price the server will ever authorize.
  • The private key never leaves your machine: it signs EIP-3009 transfer authorizations locally; settlement happens on-chain via the Coinbase facilitator.
  • Without X402_PRIVATE_KEY, tools are listed and explain how to enable payments instead of failing silently.

Env reference

VarDefaultPurpose
X402_PRIVATE_KEY—Paying wallet (USDC on Base mainnet)
MAX_PRICE_USDC0.05Per-call price ceiling
NAVI_CATALOG_URLNavi public catalogAlternative catalog source

MIT — built by Navi.

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

ما هو io.github.mobileappbyharis/navi-x402-mcp؟

Paid agent tools, zero API keys: crypto, weather, translation, web intel, x402 discovery (USDC/Base)

كيف أثبّت io.github.mobileappbyharis/navi-x402-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add navi-x402-mcp -e 'X402_PRIVATE_KEY=<your x402_private_key>' -e 'MAX_PRICE_USDC=<MAX_PRICE_USDC>' -- npx -y navi-x402-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.mobileappbyharis/navi-x402-mcp إلى مفتاح API؟

نعم. يتطلب X402_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.mobileappbyharis/navi-x402-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.mobileappbyharis/navi-x402-mcp؟

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

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