Skip to content
MCP server

ColdRead

Free signed check of an x402 paid endpoint, run by an agent before it pays

Install
Pricing
Open source
Platforms
API
Runs
Remotely
Version
0.1.0
Listing updated
2 days ago

About ColdRead

ColdRead is an open-source MCP server for security. It runs as a hosted remote server, so there is nothing to install locally.

One call returns a single report signed with a published Ed25519 key, built from four read-only checks. The endpoint check lints the unpaid 402 challenge and discovery files; the signed-offers check validates offer-receipt signatures and whether the signer is tied to the host; the ERC-8004 check compares the host's on-chain identity with the live payTo address; and the payers check labels who paid that address on Base over roughly 28 hours (self-payments, known sweepers, broad payers, dust).

Reports give an overall status of no_red_flags, attention, red_flags or unreachable, plus signals with stable IDs and a one-sentence explanation each. A clean result is not an endorsement, and every report lists what it cannot check. Freshness fields store only hashes of what was fetched, and a bundled verify.mjs script confirms a report offline.

ColdRead never pays, signs payments or holds funds. It is MIT licensed, described as run by an autonomous agent, and states that reports are software observations and chain facts, not financial advice.

Install

Run in a terminal

claude mcp add --transport http coldread https://coldread.something-agent.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://coldread.something-agent.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "coldread": {
      "url": "https://coldread.something-agent.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "coldread": {
      "type": "http",
      "url": "https://coldread.something-agent.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "coldread": {
      "serverUrl": "https://coldread.something-agent.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "coldread": {
      "type": "http",
      "url": "https://coldread.something-agent.workers.dev/mcp"
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

coldread_check
Runs the four checks on a paid endpoint URL and returns a signed report.
coldread_get_report
Fetches a previously issued report by its digest.
coldread_verify_report
Verifies a report's signature and digest.

What it does

Endpoint lint
Checks the unpaid 402 challenge, well-known x402 file, OpenAPI and llms.txt.
Signed offer check
Validates offer-receipt signatures and whether the signer is bound to the domain.
ERC-8004 identity match
Compares the host's on-chain registration with the live payTo address.
Payer analysis
Labels recent USDC payers on Base as self, sweeper, broad, narrow or dust.
Signed, verifiable reports
Each report carries an Ed25519 signature that can be verified offline.
Freshness evidence
Records hashes of fetched bodies so a buyer can prove what was checked.

Good for

  • Check an x402 seller before an agent pays it
  • Confirm a seller's payTo matches its on-chain identity
  • See whether a payTo address receives real demand or only self-payments
  • Verify a report offline before relying on it
  • Detect stale discovery data before paying

Pricing

Open source

Free, MIT licence

Prices change. Check coldread.something-agent.workers.dev before you buy.

ColdRead FAQ

Is it free?

Yes. The site and README say it is free and MIT licensed.

Does a clean report mean the seller is safe?

No. no_red_flags is not an endorsement, and each report lists what it cannot check.

Can it make payments?

No. It never pays, signs payments or holds funds; the report key only signs report digests.

How do I call it?

POST a JSON body with a url to /v1/check, or use the coldread_check tool at the /mcp endpoint.

Is ColdRead free?

Yes. ColdRead is open source, so you can use and self-host it for free.

How do I add ColdRead to Claude Code?

Run this command in your terminal: claude mcp add --transport http coldread https://coldread.something-agent.workers.dev/mcp

What are the best alternatives to ColdRead?

The closest alternatives to ColdRead are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to ColdRead

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments