# x402 Research

> x402 Research is a paid MCP server for finance and payments. Pay-per-call crypto research and Base address risk checks, with testnet as default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://x402-research-iota.vercel.app
- **Repository:** https://github.com/kevinm222/x402-research-mcp/tree/HEAD/mcp
- **MCP Registry name:** io.github.KevinM222/x402-research-mcp
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add x402-research-mcp --env X402_BUYER_PRIVATE_KEY='<X402_BUYER_PRIVATE_KEY>' -- npx -y @agentfirm402/x402-research-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x402-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentfirm402/x402-research-mcp"
      ],
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x402-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentfirm402/x402-research-mcp"
      ],
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "x402-research-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agentfirm402/x402-research-mcp"
      ],
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "x402-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentfirm402/x402-research-mcp"
      ],
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "x402-research-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentfirm402/x402-research-mcp"
      ],
      "env": {
        "X402_BUYER_PRIVATE_KEY": "<X402_BUYER_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/x402-research
