mcpField
X
x402-mcp-server

x402-mcp-server

Local
github.com/jmthomasofficialFinance0Updated 16w ago
Repository

About x402-mcp-server

x402-mcp-server is an MCP server for agent access to paid APIs covering research, finance, web tasks, and text utilities. Its README describes 25 tools paid per call in USDC on Base via x402, with no API key or signup required.

Key features

  1. 0125 pay-per-call API tools
  2. 02Company, market, and crypto research
  3. 03Web search and URL text extraction
  4. 04Summaries and deep analysis
  5. 05Text hashing, conversion, and comparison
  6. 06USDC payments through x402 on Base

Use cases

  1. 01Researching companies and SEC filings
  2. 02Checking market, crypto, or economic data
  3. 03Searching the web and summarizing sources
  4. 04Hashing or transforming text data

MCP support

Exposes paid API endpoints as MCP tools. An x402 client pays in USDC on Base mainnet when a call receives a payment-required response.

Configuration

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

mcp.json · Universal config
{
  "mcpServers": {
    "jmthomasofficial-x402": {
      "command": "npx",
      "args": [
        "-y",
        "@jmthomasofficial/x402-mcp-server"
      ],
      "env": {
        "JMT_X402_PRIVATE_KEY": "<JMT_X402_PRIVATE_KEY>"
      }
    }
  }
}
Run commandnpx -y @jmthomasofficial/x402-mcp-server
Environment variables to set
JMT_X402_PRIVATE_KEYSecretBase-mainnet wallet private key (funded with USDC). Used only to sign x402 payment authorizations. Never logged.

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
npm@jmthomasofficial/x402-mcp-server2.0.1

Tools

25

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
qstringYesQuestion to answer

Details

From the project README

JMT x402 MCP Server

25 pay-per-call API tools for AI agents, powered by the x402 protocol on Base mainnet.

What This Does

This MCP server exposes 25 paid API endpoints as MCP tools. When an AI agent (Claude, Cursor, Cline) calls a tool, the request goes to our x402 server. The first request returns HTTP 402 (Payment Required). The agent's x402 client pays in USDC on Base mainnet and retries for the result.

No API keys. No signup. Payment IS the authentication.

Tools

ToolPriceDescription
ai_answer$0.03AI-powered search answer with citations
company_intel$0.10Company intelligence dossier with SWOT analysis
sec_filing_analyzer$0.08SEC 10-K/10-Q analysis with risk extraction
news_briefing$0.05Multi-source news briefing with LLM summary
social_sentiment$0.05Cross-platform social sentiment analysis
macro_dashboard$0.04Macro economic dashboard with LLM commentary
market_pulse$0.04Stock market pulse with analyst sentiment
crypto_research$0.05Crypto research brief with on-chain analysis
competitor_analysis$0.08Competitor comparison matrix
domain_trust_score$0.04Domain trust score 0-100 with risk factors
regulatory_monitor$0.06Regulatory filing monitor with impact analysis
web_search$0.02Web search via SearXNG
url_extract$0.02Extract clean text from any URL
summarize$0.05AI-powered text summary
analyze$0.10Deep AI analysis with web research
deep_research$0.15Deep research report with sources
crypto_price$0.03Live crypto price lookup
stock_quote$0.03Live stock quote
gas_snapshot$0.002Live Base gas snapshot
treasury_yields$0.03US Treasury yield curve
whois$0.01WHOIS/RDAP domain lookup
edgar_lookup$0.01SEC EDGAR company lookup
hash$0.001Hash text (SHA-256, SHA-512, MD5)
json_to_csv$0.002Convert JSON array to CSV
text_diff$0.002Compare two text strings

Payment Setup

  • Protocol: x402 v1
  • Network: Base mainnet (eip155:8453)
  • Currency: USDC (Bridged USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
  • Facilitator: Dexter (x402.dexter.cash) — 0% fee, gas-sponsored for buyers
  • Pay-to wallet: 0x624FaF18C78456C8Da5bf156Cd77c1A2033F21c5

To make paid calls, install an x402 client:

npm install @x402/fetch @x402/evm

Installation

npm install
npm start

Discovery

License

MIT

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.