Skip to main content
Glama
Sign In
x402 MCP Server

x402 MCP Server

by jameswilliamwisdom
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Bismuth — x402 MCP Server

Pay-per-use APIs for AI agents, powered by the Bismuth (x402 API Network). One npm install, automatic USDC micropayments on Base.

License: MIT Node.js GitHub Stars

Tools

Tool

Description

Price

x402_network_info

List all APIs with pricing and health status

Free

x402_screenshot

Capture any URL as a base64 image

$0.01 / capture

x402_pdf_extract

Extract text from a PDF via URL

$0.01 / extraction

x402_sentiment

Real-time sentiment analysis for a crypto coin

$0.01 / query

x402_market_overview

Broad crypto market sentiment overview

$0.05 / query

x402_intelligence

Multi-source crypto intelligence (CoinGecko, DeFiLlama, news, GitHub)

$0.10 / query

x402_send_email

Send transactional emails via Resend with CC, BCC, and file attachments

$0.01 / email

x402_scrape_url

Scrape any URL and return structured markdown, links, tables, metadata

$0.02 / scrape

x402_convert_file

Convert files: image resize/reformat, CSV to JSON, HTML to PDF, DOCX to PDF

$0.02 / conversion

x402_web_search

Search the web via Tavily with ranked results and optional AI answer

$0.01 / search

x402_transcribe_audio

Transcribe audio files with auto language detection and word timestamps

$0.05 / transcription

x402_crawl_site

Crawl a website via BFS and return per-page markdown, links, tables, images, metadata

$0.10 / crawl

Related MCP server: @warppay402/warppay402-mcp-tools

What's New in 2.0.0

Three capability extensions and one new tool:

  • Shallow Site Crawl — new x402_crawl_site tool: BFS crawl up to 15 pages from a seed URL

  • Email CC/BCC/Attachments — x402_send_email now accepts cc, bcc, and base64 file attachments

  • DOCX to PDF — x402_convert_file now supports type: "docx" for DOCX document conversion

Quick Start — Free Mode

No wallet or private key needed. Add the server to your MCP client config:

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"]
    }
  }
}

Free mode limitations:

  • Screenshots limited to example.com, example.org, and httpbin.org

  • PDF extraction limited to first 3 pages

  • Sentiment returns mock data with real market structure

  • Email returns a fake message ID (no delivery)

  • Scraping returns fixture data (no live scraping)

  • File conversion returns fixture data (no live conversion)

  • Web search returns fixture results (no live search)

  • Transcription returns fixture transcript (no live transcription)

  • Site crawling returns fixture data (no live crawl)

Quick Start — Paid Mode

Requires a Base wallet funded with USDC.

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Never commit your private key. Store it in your system environment or a local .env file loaded by your shell.

You need USDC on the Base network. Base is an Ethereum L2 with low transaction fees. See the full wallet setup guide for detailed instructions.

MCP Client Configs

Omit the env block entirely for free mode.

Claude Desktop

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Claude Code

claude mcp add --transport stdio x402 -- npx -y x402-mcp-server

Then set X402_PRIVATE_KEY in your environment.

Cursor

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

Windsurf

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

How It Works

  1. Your AI agent calls a tool (e.g., x402_screenshot)

  2. The MCP server makes an HTTP request to the API

  3. The API responds with 402 Payment Required

  4. x402-fetch automatically signs a USDC payment on Base and retries

  5. The API returns the result

The payment flow is handled by x402-fetch — your agent never needs to manage transactions directly.

License

MIT

Available Tools

12 tools
x402_convert_fileA

Convert files between formats — image resize/reformat, CSV to JSON, HTML to PDF, or DOCX to PDF. Price: $0.02 USDC per conversion (paid mode) | Free test: returns fixture data.

Supported conversions:

  • image: resize/reformat an image from a URL (Pillow) — outputs base64-encoded bytes

  • csv: convert a CSV URL to JSON array

  • html_pdf: render HTML from a URL to PDF — outputs base64-encoded bytes

  • docx: convert a DOCX document URL to PDF — outputs base64-encoded bytes (mammoth + WeasyPrint, content-fidelity not layout-preserving)

Input limit: 10MB source file. Output limit: 8MB (before base64 encoding). Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: base64-encoded output bytes with MIME type, or JSON array for csv type.

Inputs: url (required), type (required), format, width, +1 more.

x402_crawl_siteA

Crawl a website via BFS and return per-page extraction results (markdown, links, tables, images, metadata). Price: $0.10 USDC per crawl (paid mode) | Free test: returns fixture data.

Crawls up to max_pages pages starting from the seed URL, up to max_depth link hops deep. Same extraction pipeline as x402_scrape_url — each page returns markdown, links, tables, images, metadata. Optional include_paths/exclude_paths glob filters (e.g. '/blog/*') restrict which URLs are followed. Hard limits: max 15 pages, max depth 5. Response includes pages_requested, pages_crawled, pages_skipped. Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: seed_url, pages_requested, pages_crawled, pages_skipped, reasons_skipped, results array.

Inputs: url (required), max_pages, max_depth, include_paths, +1 more.

x402_intelligenceA

Get comprehensive multi-source intelligence analysis for a cryptocurrency. Price: $0.10 USDC per query.

Aggregates data from CoinGecko (market), DeFiLlama (TVL/DeFi), CryptoPanic (news), Fear & Greed Index (psychology), and GitHub (development activity). All data synthesized by Claude AI for actionable insights.

This is the premium tier — use x402_sentiment ($0.01) for quick sentiment only. Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: comprehensive analysis with market data, news, development activity, and AI synthesis.

Inputs: coin (required).

x402_market_overviewA

Get a broad crypto market sentiment overview covering major coins and trends. Price: $0.05 USDC per query.

Provides aggregate sentiment across the crypto market. Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: market-wide sentiment data, top movers, and trend analysis.

Inputs: no named parameters.

x402_network_infoA

List all APIs in the x402 API Network with pricing, status, and capabilities. This tool is FREE — no payment required.

The x402 API Network provides pay-per-use APIs accepting USDC micropayments on Base (L2 Ethereum).

Inputs: no named parameters.

x402_pdf_extractA

Extract text content from a PDF document via URL. Price: $0.01 USDC per extraction.

Uses PyMuPDF for fast text extraction. Handles multi-page PDFs. Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: extracted text, page count, and metadata.

Inputs: pdf_url (required).

x402_scrape_urlA

Scrape a web page and return structured JSON with markdown content, links, tables, images, and metadata. Price: $0.02 USDC per scrape (paid mode) | Free test: returns fixture data.

Supports JS-rendered pages via Playwright. Optional wait_for CSS selector for async SPA content. Hard timeout: 8 seconds total (page load + selector wait combined). Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: markdown text, extracted links, tables, images, page metadata, and success/failure status.

Inputs: url (required), wait_for.

x402_screenshotA

Capture a screenshot of any URL and return it as a base64-encoded image. Price: $0.01 USDC per capture (paid mode) | Free test: example.com, example.org, httpbin.org only.

Without X402_PRIVATE_KEY, only test domains are available. With a wallet key, any URL can be captured via the paid endpoint.

Returns: base64 PNG/JPEG/WebP image data.

Inputs: url (required), width, height, full_page, +1 more.

x402_send_emailA

Send a transactional email via Resend. Price: $0.01 USDC per email (paid mode) | Free test: returns fixture data.

Supports plain text or HTML body, CC/BCC recipients, and file attachments (base64-encoded, max 25MB per file). Per-wallet daily limit: 10 emails. Per-domain daily limit: 5 emails (applies to all recipients including CC/BCC). Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: message_id from Resend.

Inputs: to (required), subject (required), body (required), reply_to, +3 more.

x402_sentimentA

Get real-time crypto sentiment analysis for a specific coin. Price: $0.01 USDC per query.

Analyzes social media, news, and market data to produce sentiment scores. Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: sentiment score (-1 to 1), confidence, sources, and analysis.

Inputs: coin (required).

x402_transcribe_audioA

Transcribe an audio file from a URL using faster-whisper with auto language detection. Price: $0.05 USDC per transcription (paid mode) | Free test: returns fixture data.

Supports: MP3, WAV, M4A, FLAC, OGG, and most audio formats. Limits: 25MB file size, 10-minute duration. Payment is charged on download; duration refusals are still charged. Note: transcription can take 30–120 seconds for longer files (CPU-based, requests queue serially). Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: transcript text, detected language, language confidence, duration, and segment or word timestamps.

Inputs: url (required), language, word_timestamps.

x402_web_searchA

Search the web and return ranked results via Tavily — title, URL, snippet, and relevance score. Price: $0.01 USDC per search (paid mode) | Free test: returns fixture data.

Optional synthesized answer summarizing results. Use include_domains/exclude_domains for focused research. Per-wallet daily limit: 50 queries (resets midnight UTC). Without X402_PRIVATE_KEY, only the free test endpoint is available.

Returns: query, results array (title, url, snippet, score), optional answer field.

Inputs: query (required), max_results, include_answer, include_domains, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.1/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have distinct purposes (e.g., file conversion, web scraping, email sending), but there is some overlap between x402_intelligence and x402_sentiment/x402_market_overview in crypto analysis, which could cause confusion. However, descriptions clarify that x402_intelligence is comprehensive while others are focused, mitigating ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent 'x402_' prefix with snake_case and descriptive verb_noun patterns (e.g., x402_convert_file, x402_scrape_url). This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming style.

    Tool Count4/5

    With 12 tools, the count is reasonable for a multi-purpose utility server covering file processing, web operations, crypto analysis, and communication. It's slightly broad but manageable, as each tool serves a specific function without obvious redundancy.

    Completeness3/5

    The server covers diverse domains like file conversion, web scraping, crypto analysis, and email, but within each domain, coverage is basic. For example, file conversion supports specific formats but lacks broader editing tools, and crypto tools focus on sentiment/overview without deeper analytics like trading or portfolio management, leaving gaps for advanced use cases.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers