# Mercury402: Treasury/FRED financial data over x402

> Mercury402: Treasury/FRED financial data over x402 is a paid MCP server for finance and payments. Pay-per-call US Treasury, FRED and forex data for agents, priced in USDC on Base. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://mercury402.com
- **Repository:** https://github.com/dudman1/mercury402/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.dudman1/mercury402-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

Mercury402 sells US financial data one request at a time using the x402 protocol: an unpaid request gets an HTTP 402 with a price, the client pays in USDC on Base, and the data comes back as signed JSON with provenance. The site counts 78 live endpoints across Treasury (4), FRED series (53), forex (4), yield spreads (5), breakeven inflation (4), macro intelligence (3) and composites (3).

The MCP server has two tools and a deliberately cautious default. In free mode, list_endpoints browses every route and price and get_endpoint_data returns the quote and payment instructions without spending anything. Paid mode is opt-in: you set MERCURY402_PAYER_PRIVATE_KEY, and the server pays each 402 up to MERCURY402_MAX_PRICE_USD, which defaults to 0.5 dollars. The README warns that the key sits in plaintext in your client config, so use a dedicated low-balance wallet and avoid the project scope in Claude Code.

Only paths in the catalog can be called. The site quotes $0.05 for base endpoints, $0.10 for macro premium, $0.40 for inflation and labor composites and $0.50 for the economic dashboard. It needs Node.js 20.10 or newer, or a hosted Streamable HTTP endpoint.

## Features

- **78 data endpoints:** Treasury, 53 FRED series, forex, spreads, inflation and composites.
- **Free discovery mode:** Browse routes and prices and get quotes without spending.
- **Opt-in paid mode:** Pays USDC on Base per call with a configurable per-call cap.
- **x402 payments:** Standard 402 quotes with no accounts or API keys.
- **Catalog-only calls:** Paths outside the catalog are rejected before any request is sent.
- **Provenance in responses:** Responses carry structured data and provenance for reproducibility.

## Good for

- Let an agent fetch the latest Treasury yield curve
- Pull a FRED series such as UNRATE into a workflow
- Preview the price of an endpoint before paying
- Build agent workflows that pay per request without accounts
- Compare yield spreads and breakeven inflation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mercury402-mcp https://mcp.mercury402.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.mercury402.com/mcp
```

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

```json
{
  "mcpServers": {
    "mercury402-mcp": {
      "url": "https://mcp.mercury402.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mercury402-mcp": {
      "type": "http",
      "url": "https://mcp.mercury402.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mercury402-mcp": {
      "serverUrl": "https://mcp.mercury402.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mercury402-mcp": {
      "type": "http",
      "url": "https://mcp.mercury402.com/mcp"
    }
  }
}
```

## Tools

- `list_endpoints`: Lists all 78 endpoints with path, method, category, description, price and parameters, with optional category and search filters.
- `get_endpoint_data`: Calls a catalog endpoint and returns the data, or the 402 quote and how to pay.

## FAQ

### Does it spend money by default?

No. The default free mode lists endpoints and returns quotes. Spending needs a payer private key.

### How much does a call cost?

From $0.05 for base endpoints up to $0.50 for the economic dashboard.

### Is my wallet key safe?

The README warns it is stored in plaintext in the client config, so use a dedicated wallet with a small USDC balance.

### What does it need installed?

Node.js 20.10 or newer, or use the hosted Streamable HTTP endpoint.

### Is Mercury402: Treasury/FRED financial data over x402 free?

No. Mercury402: Treasury/FRED financial data over x402 is a paid product.

### How do I add Mercury402: Treasury/FRED financial data over x402 to Claude Code?

Run this command in your terminal: claude mcp add --transport http mercury402-mcp https://mcp.mercury402.com/mcp

### What are the best alternatives to Mercury402: Treasury/FRED financial data over x402?

The closest alternatives to Mercury402: Treasury/FRED financial data over x402 are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [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.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/mercury402-treasury-fred-financial-data-over-x402
