x402 Research
Pay-per-call crypto research and Base address risk checks, with testnet as default
- Pricing
- Paid
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
- 2 days ago
About x402 Research
x402 Research is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
This is the stdio client for the Agent Firm x402 research API. Each paid tool settles in USDC on Base through x402, and the server signs from a buyer wallet key you provide. It starts on Base Sepolia, and mainnet only works if you set X402_NETWORK=eip155:8453. With no key set, it runs in preview mode and returns decoded 402 terms without paying.
Safety limits are strict: 0.10 USDC per call and 0.50 per session by default, offers refused if above the advertised price, on another network, or in a non-canonical USDC asset, and a hardcoded payTo allowlist limited to the Agent Firm treasury. The README warns to use a dedicated low-balance wallet.
The flagship preflight check combines a risk snapshot, live ERC-20 approvals, an OFAC SDN screen and an optional invoice check for $0.05, against $0.08 if bought separately. Market tools cover 20 assets with RSI, moving averages and Fear and Greed data. Output is informational, not financial advice.
Install
Run in a terminal
claude mcp add x402-research-mcp --env X402_BUYER_PRIVATE_KEY='<X402_BUYER_PRIVATE_KEY>' -- npx -y @agentfirm402/x402-research-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"x402-research-mcp": {
"command": "npx",
"args": [
"-y",
"@agentfirm402/x402-research-mcp"
],
"env": {
"X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-research-mcp": {
"command": "npx",
"args": [
"-y",
"@agentfirm402/x402-research-mcp"
],
"env": {
"X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402-research-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentfirm402/x402-research-mcp"
],
"env": {
"X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402-research-mcp": {
"command": "npx",
"args": [
"-y",
"@agentfirm402/x402-research-mcp"
],
"env": {
"X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402-research-mcp": {
"command": "npx",
"args": [
"-y",
"@agentfirm402/x402-research-mcp"
],
"env": {
"X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
}
}
}
}Configuration
X402_NETWORKNetwork: eip155:84532 (Base Sepolia, default) or eip155:8453 (Base mainnet)X402_BUYER_PRIVATE_KEYBuyer wallet key that pays per call (capped 0.10 USDC/call, 0.50/session on mainnet)
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- signal
- Short market signal for an asset
- signal_batch
- Signals for up to 10 assets
- brief
- Technical and sentiment brief
- risk_snapshot
- Red-flag snapshot for a Base address
- invoice_decode
- Decode and check an x402 payment header
- settlement_status
- Check an x402 settlement transaction
- approval_enumerate
- List live ERC-20 approvals
- preflight
- Combined address, approvals, invoice and sanctions check
- session_status
- Free local spend status
What it does
- Address preflight
- Verdict of proceed, review or stop for a Base address.
- Approval enumeration
- Lists live ERC-20 approvals and flags unlimited allowances.
- x402 invoice checks
- Decodes payment headers and checks policy before you sign.
- Settlement status
- Confirms a Base transaction and its USDC transfer events.
- Market briefs and signals
- Technical and sentiment data for 20 assets.
- Preview mode
- Shows prices without paying.
Good for
- Screen an unknown Base address before interacting
- Check an x402 invoice before signing
- Confirm an x402 payment settled
- Pull a quick market brief for an asset
Pricing
Paid
Pay per call in USDC: $0.003 to $0.05
Prices change. Check x402-research-iota.vercel.app before you buy.
x402 Research FAQ
Is it safe to test?
Yes. It defaults to Base Sepolia and preview mode when no key is set.
What are the spending caps?
0.10 USDC per call and 0.50 per session by default.
Whom does it pay?
Only the hardcoded Agent Firm treasury address.
How much does it cost?
Prices range from $0.003 for a signal to $0.05 for preflight.
Is x402 Research free?
No. x402 Research is a paid product.
How do I add x402 Research to Claude Code?
Run this command in your terminal: claude mcp add x402-research-mcp --env X402_BUYER_PRIVATE_KEY='<X402_BUYER_PRIVATE_KEY>' -- npx -y @agentfirm402/x402-research-mcp
What are the best alternatives to x402 Research?
The closest alternatives to x402 Research are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.
Alternatives to x402 Research

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments