Developer Docs

Use the bluerails402 MCP server to give your AI agent access to paid content publishers.

Claude Desktop setup

Add the following to your claude_desktop_config.json:

Replace YOUR_BLUE402_API_KEY_HERE with your key from the account page.

claude_desktop_config.json

{
  "mcpServers": {
    "bluerails402": {
      "type": "http",
      "url": "https://bluerails402.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_BLUE402_API_KEY_HERE"
      }
    }
  }
}

Authentication

Public tools (list_publishers, get_publisher) are available without authentication. The get_fx_quote and fetch_content tools require a valid X-API-Key header issued to your operator.

Tool reference

list_publishers

Search and list all active publishers in the bluerails402 registry. Supports full-text search and content type filtering.

Signature

list_publishers(query?: string, content_type?: string, page?: number) → Publisher[]

Example call

list_publishers({ query: "german news", content_type: "news" })

Example response

[
  {
    "id": "pub_bild",
    "slug": "bild",
    "name": "Bild",
    "shortDescription": "Germany's largest daily newspaper",
    "trustTier": "silver",
    "usdcPricePerRequest": "0.001",
    "contentTypes": ["news", "media"],
    "supportedProtocols": ["x402"]
  }
]

get_publisher

Retrieve full details for a single publisher by slug, including sample URLs, search pattern, and payment address.

Signature

get_publisher(slug: string) → PublisherDetail | null

Example call

get_publisher({ slug: "bild" })

Example response

{
  "slug": "bild",
  "name": "Bild",
  "networkId": "base",
  "payToAddress": "0xAllUnityFacilitator...",
  "sampleUrls": ["https://bild.de/article/123"],
  "searchPattern": "https://bild.de/article/*"
}

get_fx_quote

Get a real-time FX quote for converting between currencies. Used by agents to estimate EUR cost of a USDC payment.

Signature

get_fx_quote(from: string, to: string, amount: number) → FxQuote

Example call

get_fx_quote({ from: "USDC", to: "EUR", amount: 0.001 })

Example response

{
  "from": "USDC",
  "to": "EUR",
  "amount": 0.001,
  "rate": 0.921,
  "convertedAmount": 0.000921,
  "timestamp": "2026-05-14T12:00:00Z"
}

fetch_content

Phase 6 STUB — resolves the URL to a registered publisher. Payment ships in Phase 7. Requires X-API-Key.

Signature

fetch_content(url: string) → StubResponse

Example call

fetch_content({ url: "https://bild.de/article/123" })

Example response

{
  "status": "not_implemented",
  "phase": 7,
  "message": "Payment execution is not yet available. bluerails402.com is currently in registry-only mode. Phase 7 adds the CF Worker + AllUnity facilitator integration + EIP-3009 payment flow.",
  "publisher": {
    "slug": "bild",
    "name": "Bild",
    "shortDescription": "Germany's largest daily newspaper — premium digital content",
    "trustTier": "silver",
    "usdcPricePerRequest": "0.001",
    "supportedProtocols": ["x402"]
  },
  "url": "https://bild.de/article/123"
}