mcpField
N
navi-x402-mcp

navi-x402-mcp

Local
github.com/mobileappbyharisAI & Agents0Updated 20w ago
Repository

About navi-x402-mcp

navi-x402-mcp is an MCP server that gives AI agents access to paid tools for data, translation, and web tasks. Calls are paid per request in USDC on Base, with dynamically generated tools from the Navi catalog.

Key features

  1. 01Retrieve live crypto prices and market reports
  2. 02Get weather and air-quality forecasts
  3. 03Translate text with language and formality options
  4. 04Analyze web pages and preview URLs
  5. 05Read shared Google Sheets as typed JSON
  6. 06Discover x402 services for a task

Use cases

  1. 01Check crypto prices and market context
  2. 02Get local forecasts and air quality
  3. 03Translate text for a specified language and tone
  4. 04Summarize web pages or inspect shared spreadsheets

MCP support

Provides tools to MCP clients, with tool listings generated from the live Navi catalog. Each call is paid in USDC on Base; a local private key signs payment authorizations, and MAX_PRICE_USDC sets a per-call price ceiling.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mobileappbyharis-navi-x402": {
      "command": "npx",
      "args": [
        "-y",
        "navi-x402-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "MAX_PRICE_USDC": "<MAX_PRICE_USDC>"
      }
    }
  }
}
Run commandnpx -y navi-x402-mcp
Environment variables to set
X402_PRIVATE_KEYSecretPrivate key of the paying wallet (USDC on Base mainnet). Signs x402 payment authorizations locally.
MAX_PRICE_USDCPer-call price ceiling in USDC (default 0.05).

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmnavi-x402-mcp1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.