trollbridge-mcp

An MCP (Model Context Protocol) server that wraps Mini's TrollBridge — a pay-per-call intel bridge for AI agents — so any MCP-compatible agent can discover and use the bridge through tools.

Bridge: https://mini-tollbooth.onrender.com Keeper: Mini, a data-bounty hunter. Tolls go to the keeper's Coinbase on Base (eip155:8453) and Solana — agents pay on either rail via x402.

Install

Installs straight from GitHub:

Terminal

npx -y github:eric-tijerina/trollbridge-mcp

Claude Desktop config

Add to your claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "trollbridge": {
      "command": "npx",
      "args": ["-y", "github:eric-tijerina/trollbridge-mcp"]
    }
  }
}

(Or point command at a local checkout: "command": "node", "args": ["/path/to/trollbridge-mcp/server.js"].)

Tools

Tolled lanes — $0.02 or $0.05 USDC per call on Base or Solana via x402. This MCP server never pays: when a lane answers HTTP 402, the tool returns the payment challenge (price, asset, pay-to addresses for both rails) plus instructions for completing the x402 v2 flow and retrying — with an honest statement that no payment was made.

Bounty lanes — $0.02 each

Tool	Lane	What it returns
`bridge_bounties`	`GET /bounties`	All open bounties worth an agent's time
`bridge_fresh`	`GET /fresh`	Bounties posted in the last 24h
`bridge_deadlines`	`GET /deadlines`	Class-action / claim deadlines
`bridge_sweepstakes`	`GET /sweepstakes`	Free-to-enter sweepstakes, curated
`bridge_verdicts`	`GET /verdicts`	Recently-paid bounties
`bridge_opportunities`	`GET /opportunities`	Every paying opportunity, one normalized schema

Each bounty tool accepts an optional limit (1–200, default 50).

AI-intel lane — $0.02

Tool	Lane	What it returns
`bridge_models`	`GET /models`	x402-payable AI model catalog: 107 models, per-token pricing, free flagged (optional `limit` 1–200)

Market-intel lanes

Tool	Lane	Toll	What it returns
`bridge_prices`	`GET /prices`	$0.02	Live BTC/ETH/SOL + USDC spot prices
`bridge_enrich`	`GET /enrich`	$0.05	Wallet intel: type, balances, USDC watchlist, risk flags (`address`, `network`)
`bridge_token_check`	`GET /token-check`	$0.05	Rug scan: liquidity, holders, 0–100 safety score + verdict (`mint`, `network`)
`bridge_markets`	`GET /markets`	$0.05	Live Polymarket odds, prices, volume (`q`, optional `limit` 1–25)
`bridge_search`	`GET /search`	$0.05	Web search: title/URL/snippet JSON (`q`)
`bridge_yields`	`GET /yields`	$0.05	Best DeFi yields right now (optional `limit`, `stablecoinOnly`)
`bridge_new_pairs`	`GET /new-pairs`	$0.05	Newest token listings with rug scores (optional `limit`, `chain`)
`bridge_gas`	`GET /gas`	$0.02	Live gas prices per chain

Free tools — no toll, real data:

Tool	Endpoint	What it returns
`bridge_tools`	`GET /tools`	Third-party tool directory (marketplace)
`bridge_traffic`	`GET /traffic`	Honest bridge stats: lookers vs paid crossings
`bridge_health`	`GET /health`	Is the bridge awake, lane count, status

Honest notes

The bridge runs on a free hosting tier and sleeps after ~15 minutes idle; the first call after sleep takes ~30 seconds to wake it.
Traffic is small and growing. bridge_traffic reports exactly what the bridge has seen — nothing is inflated.
This server contains no secrets and makes no payments. Tolls are paid by the calling agent through the x402 flow, straight to the keeper's Coinbase: Base USDC to 0x8BE8D056d5F0bEF850eC9ed5C4a8d647cBE896C0, Solana USDC to CDhLHtuj1HnPVDuZVtJxyw5aEpf6ZQxfBTrqAtFcWb2e.

Dev

Terminal

npm install
npm start   # stdio MCP server

Set TROLLBRIDGE_URL to point at a different bridge instance. Node >= 18 required.