# databroker

Connects an agent to MossForge DataBroker for UK MOT history and reliability data. Calls are paid in USDC on Base, with no API keys or subscription.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: mossforge
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mossforge/databroker/tree/HEAD/mcp-server
- Updated: 2026-08-30
- HTML: https://affpapa.org/en/nevibecode/mcp/databroker

## What it does

The server starts with `npx -y @mossforge/databroker-mcp` and exposes several tools. `databroker_discover` lists the enabled datasets and their USDC price per call, while `databroker_meta` returns staleness, TTL and source details without charging. `databroker_fetch` pulls one datapoint by key. `databroker_batch_create` takes up to 100 keys from a single dataset as one job under one payment, and `databroker_batch_status` polls that job.

Every paid tool quotes first. Money moves only on a second call carrying `confirm: true`, and `DATABROKER_MAX_USDC` (default 0.50) rejects anything priced higher before payment. On clients that advertise MCP elicitation, the server asks the human to approve the exact URL and amount itself; Claude gained this in v2.1.76. Elsewhere the check is skipped and the `confirm: true` flag plus the cap are all that stands between the model and your wallet.

You need a funded wallet on Base mainnet. In `raw` mode the private key sits in `DATABROKER_WALLET_KEY` and signs locally. The `cdp` mode pays through a Coinbase-managed wallet and wants `CDP_API_KEY_ID`, `CDP_API_KEY_SECRET` and `CDP_WALLET_SECRET`, plus an installed `@coinbase/cdp-sdk`. In raw mode the key is as safe as the process environment around it, so a fresh wallet holding a small balance is the sane choice.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DATABROKER_BASE_URL`, `DATABROKER_SIGNER`, `DATABROKER_WALLET_KEY`, `CDP_API_KEY_ID`, `CDP_API_KEY_SECRET`, `CDP_WALLET_SECRET`, `DATABROKER_MAX_USDC` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add databroker -e DATABROKER_BASE_URL=<DATABROKER_BASE_URL> -e DATABROKER_WALLET_KEY=<DATABROKER_WALLET_KEY> -e CDP_API_KEY_ID=<CDP_API_KEY_ID> -e CDP_API_KEY_SECRET=<CDP_API_KEY_SECRET> -e CDP_WALLET_SECRET=<CDP_WALLET_SECRET> -- npx -y @mossforge/databroker-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server --env DATABROKER_BASE_URL=<DATABROKER_BASE_URL> --env DATABROKER_SIGNER=<DATABROKER_SIGNER> --env DATABROKER_WALLET_KEY=<DATABROKER_WALLET_KEY> --env CDP_API_KEY_ID=<CDP_API_KEY_ID> --env CDP_API_KEY_SECRET=<CDP_API_KEY_SECRET> -- npx -y @mossforge/databroker-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@mossforge/databroker-mcp"
            ],
            "env": {
                "DATABROKER_BASE_URL": "<DATABROKER_BASE_URL>",
                "DATABROKER_SIGNER": "<DATABROKER_SIGNER>",
                "DATABROKER_WALLET_KEY": "<DATABROKER_WALLET_KEY>",
                "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
                "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mossforge/databroker-mcp"
            ],
            "env": {
                "DATABROKER_BASE_URL": "<DATABROKER_BASE_URL>",
                "DATABROKER_SIGNER": "<DATABROKER_SIGNER>",
                "DATABROKER_WALLET_KEY": "<DATABROKER_WALLET_KEY>",
                "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
                "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DATABROKER_BASE_URL=<DATABROKER_BASE_URL> -e DATABROKER_SIGNER=<DATABROKER_SIGNER> -e DATABROKER_WALLET_KEY=<DATABROKER_WALLET_KEY> -e CDP_API_KEY_ID=<CDP_API_KEY_ID> -e CDP_API_KEY_SECRET=<CDP_API_KEY_SECRET> mcp-server npx -y @mossforge/databroker-mcp
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- check a car's MOT record before agreeing to buy it
- see whether the odometer reading matches the test history
- fetch a hundred keys in one job and one payment
- inspect data freshness and source without spending
- keep a single call under a hard spend cap

## Example prompts
- Should I buy a 2018 Golf with reg `AB18 CDE`? Look up its MOT history and tell me if the mileage is plausible.
- List the datasets that are switched on and what each call costs.
- Run a batch over these 50 registration numbers and show me the total quote before paying.

## Similar
- [Pyrimid Protocol](https://affpapa.org/en/nevibecode/mcp/pyrimid-protocol.md) — MCP server
- [x402](https://affpapa.org/en/nevibecode/skills/x402.md) — skill · 1300 installs
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548
- [mcp-x402](https://affpapa.org/en/nevibecode/mcp/mcp-x402.md) — MCP server · ★ 274
- [payanagent](https://affpapa.org/en/nevibecode/mcp/payanagent.md) — MCP server · ★ 6
- [BotsRated (beta)](https://affpapa.org/en/nevibecode/mcp/botsrated-beta.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
