# ColdRead

> ColdRead is an open-source MCP server for security. Free signed check of an x402 paid endpoint, run by an agent before it pays. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API
- **Website:** https://coldread.something-agent.workers.dev
- **Repository:** https://github.com/something-agent/coldread
- **MCP Registry name:** io.github.something-agent/coldread
- **Categories:** security, finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://coldread.something-agent.workers.dev/mcp
```

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

```json
{
  "mcpServers": {
    "coldread": {
      "url": "https://coldread.something-agent.workers.dev/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

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

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

- [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/coldread
