Mercury402: Treasury/FRED financial data over x402

Treasury/FRED financial data over x402: pay-per-call US yields, macro and forex in USDC on Base

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
95%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~487Tokens (tool definitions)
~1.4 KBTypical response size
Minimal attention impact (0.38% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "mercury402-mcp": {
      "command": "npx",
      "args": [
        "mercury402-mcp"
      ]
    }
  }
}

Runnable packages

npmmercury402-mcp0.1.4stdio

Remote endpoints

https://mcp.mercury402.com/mcpstreamable-http

What it can do

Tool inventory

Tools (2)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_endpoints(category, search)

List Mercury402 financial data endpoints (78 total) with path, method, category, description, price in USD (paid per call in USDC on Base via x402) and accepted parameters. Free; makes no network calls.

Input Schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "ai",
        "breakeven-inflation",
        "composite",
        "forex",
        "fred",
        "macro",
        "treasury",
        "yield-spread"
      ],
      "description": "Only return this category"
    },
    "search": {
      "type": "string",
      "description": "Case-insensitive substring match on path or description"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_endpoint_data(path, params, pay)

Call a Mercury402 endpoint on the live API. This hosted endpoint is discovery-only: endpoints return HTTP 402 and this tool returns the price and x402 payment instructions instead of data. Pay with your own x402 client, or run mercury402-mcp locally (npx -y mercury402-mcp) with your own wallet. Use list_endpoints first to find paths and parameters. Path params can be inline ("/v1/fred/UNRATE") or passed in params ("/v1/fred/{series_id}" + {"series_id":"UNRATE"}). Other params go to the query string (GET) or JSON body (POST).

Input Schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path, e.g. \"/v1/treasury/yield-curve/daily-snapshot\" or \"/v1/fred/UNRATE\""
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        ]
      },
      "description": "Path, query (GET) or body (POST) parameters"
    },
    "pay": {
      "type": "boolean",
      "description": "Paid mode only: set false to just get the price quote without paying. Default true."
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded2 tools