English Français العربية

io.github.mobileappbyharis/navi-x402-mcp

Official registry Finance and payments

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

Source code Documentation

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).

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 configuration (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>"
            }
        }
    }
}

Environment variables

  • X402_PRIVATE_KEY required secret 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).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is io.github.mobileappbyharis/navi-x402-mcp?

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

How do I install io.github.mobileappbyharis/navi-x402-mcp?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.mobileappbyharis/navi-x402-mcp need an API key?

Yes. It expects X402_PRIVATE_KEY, which you set in its configuration.

Is io.github.mobileappbyharis/navi-x402-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.mobileappbyharis/navi-x402-mcp?

It is published by mobileappbyharis. 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.