How do I use trollbridge-mcp?

This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions: * TrollBridge MCP

trollbridge-mcp

by eric-tijerina

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

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:

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

Related MCP server: x402-bazaar-mcp

Claude Desktop config

Add to your claude_desktop_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

npm install
npm start   # stdio MCP server

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

Available Tools

18 tools

bridge_bountiesAInspect

Mini's TrollBridge — ALL open bounties worth an agent's time (aibtc, Taskmarket, Superteam), refreshed every 6 hours. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_deadlinesBInspect

Mini's TrollBridge — upcoming class-action and claim deadlines (money with an expiry date). TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_enrichAInspect

Mini's TrollBridge — wallet address intel: type, native balance, USDC watchlist, risk flags. TOLLED: $0.05 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Requires address and network.

Inputs: address (required), network (required).

bridge_freshAInspect

Mini's TrollBridge — bounties posted in the last 24 hours. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_gasAInspect

Mini's TrollBridge — live gas prices per chain, for agents about to move money. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. No params.

Inputs: no named parameters.

bridge_healthBInspect

Mini's TrollBridge — FREE health check: is the bridge awake, how many lanes, marketplace status. No toll.

Inputs: no named parameters.

bridge_marketsAInspect

Mini's TrollBridge — prediction-market intel: live Polymarket odds, prices, and volume, agent-ready JSON. TOLLED: $0.05 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Requires q; optional limit 1-25.

Inputs: q (required), limit.

bridge_modelsAInspect

Mini's TrollBridge — x402-payable AI model catalog: 107 models with per-million-token pricing, free models flagged (catalog data: BlockRun.AI). TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_new_pairsAInspect

Mini's TrollBridge — newest token listings with rug scores attached, for check-then-ape sniping. TOLLED: $0.05 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-50, chain.

Inputs: chain, limit.

bridge_opportunitiesAInspect

Mini's TrollBridge — every paying opportunity in one normalized schema: title, payout amount and token, chain, URL, requirements, deadline, board. One call, every board. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_pricesAInspect

Mini's TrollBridge — spot crypto prices: BTC, ETH, SOL, USDC. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. No params.

Inputs: no named parameters.

bridge_searchAInspect

Mini's TrollBridge — web search for agents: title, url, snippet per result, agent-ready JSON. TOLLED: $0.05 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Requires q.

Inputs: q (required).

bridge_sweepstakesAInspect

Mini's TrollBridge — free-to-enter sweepstakes with real prizes, curated by Mini. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_token_checkAInspect

Mini's TrollBridge — token rug scan: liquidity, volume, buys/sells, holder concentration, heuristic 0-100 score plus a plain verdict. TOLLED: $0.05 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Requires mint and network.

Inputs: mint (required), network (required).

bridge_toolsBInspect

Mini's TrollBridge — FREE directory of third-party AI tools listed on the TrollBridge marketplace (developers list tools, agents pay per use). No toll.

Inputs: no named parameters.

bridge_trafficBInspect

Mini's TrollBridge — FREE bridge statistics: per-lane toll challenges (lookers) vs paid crossings (agents through), unique payer wallets, first/last seen. Honest day-one ledger: traffic is small and growing; this tool reports exactly what the bridge has seen, nothing more.

Inputs: no named parameters.

bridge_verdictsAInspect

Mini's TrollBridge — recently-paid bounties: which bounties actually paid out and how much. TOLLED: $0.02 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-200.

Inputs: limit.

bridge_yieldsAInspect

Mini's TrollBridge — best DeFi yields right now: stablecoin APYs and more, for yield-hunting agents. TOLLED: $0.05 USDC per call on Base or Solana via x402. If you cannot pay, this tool returns the 402 payment instructions instead of data. Optional limit 1-50, stablecoinOnly.

Inputs: limit, stablecoinOnly.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-10-15 11:55 across 18 tools

Disambiguation3/5

Most tools target clearly distinct data domains (prices, gas, yields, token scans, markets, search), but bridge_bounties, bridge_fresh, and bridge_opportunities all aggregate paying opportunities/bounties across boards with overlapping intent — bridge_opportunities explicitly claims to normalize 'every paying opportunity' which seems to subsume the other two. An agent cannot easily tell when to call bounties vs opportunities vs fresh. bridge_verdicts and bridge_deadlines are reasonably distinct from these.

Naming Consistency5/5

Every tool follows a strict bridge_<noun> snake_case pattern with a single consistent prefix. No camelCase mixing or verb-style drift. Names are predictable and readable even if some nouns (bridge_fresh, bridge_enrich) require reading the description.

Tool Count4/5

18 tools is on the heavy side but each generally maps to a distinct data feed, so most earn their place. The one soft spot is the bounties/opportunities/fresh cluster, which could arguably be collapsed into one parameterized tool. Slightly over-scoped but reasonable for a multi-feed data marketplace.

Completeness4/5

The bridge covers a broad market/bounty/on-chain intel surface: listings, opportunities, deadlines, payouts, prices, gas, models, token risk, prediction markets, search, yields, new pairs, plus free traffic/health observability. Minor gaps exist (e.g. no explicit wallet-balance or payment-status tool, though x402 handles tolling), but agents can work around them.

Maintenance

ActivitySlowing

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

sovereign-engineA
io.github.invertedhoologan
15 paid AI agent primitives via x402 (USDC on Base). Pay-per-call MCP server.
AI & Machine Learning Payments & Billing Cryptocurrency
2
https://api.zuluworksai.com/mcp
Apex Edge — x402-paid machine services
net.nonsynthetic
x402-paid MCP tools & data APIs for agents — USDC on Base + Solana
Payments & Billing Blockchain Cryptocurrency
1
https://api.nonsynthetic.net/mcp
BridgeNode MCPA
io.github.bridgenode-ai
BridgeNode — x402 pay-per-request AI inference. OpenAI-compatible API + MCP, Solana USDC, gas-free.
AI & Machine Learning Cryptocurrency
311
https://bridgenode.cc/mcp
volatiai-mcpA
io.github.christianscode1994
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
Finance Data Platforms AI & Machine Learning
211
https://volatiai-mcp.fourieranalys.workers.dev/mcp

Related MCP Servers

Clawswap
Blockchain Cryptocurrency Web3 & Decentralized Tech
WarTech9
A
license
A
quality
D
maintenance
MCP server providing cross-chain swaps between Solana and Base for AI agents paid for via x402 micropayments.
Updated 9 months ago (2026-02-27 06:32 UTC)
3
88 npm
2
MIT
x402-bazaar-mcp
Blockchain Cryptocurrency AI & Machine Learning
sukrutkrdg
A
license
B
quality
B
maintenance
MCP server exposing x402 Bazaar's paid Base APIs (token risk/honeypot, prices, gas, wallet intel, tx decode + AI utilities) as agent tools. Your agent pays per call in USDC over x402 — no API keys, no signup.
Updated a month ago (2026-10-14 15:52 UTC)
17
166 npm
MIT
x402farm-mcp
Cryptocurrency Blockchain Web Scraping
laurenthalbrun
A
license
Not graded
quality
D
maintenance
MCP server that provides AI agents with pay-per-call access to a suite of tools (honeypot check, token market, DeFi yields, etc.) via USDC on Base using the x402 protocol.
Updated 4 months ago (2026-07-29 01:15 UTC)
11 npm
MIT
AgentServices
Cryptocurrency Blockchain AI & Machine Learning
vbkotecha
A
license
Not graded
quality
C
maintenance
MCP server providing 50+ crypto, market intelligence, and AI inference endpoints with x402 pay-per-request micropayments on Base.
Updated a month ago (2026-10-02 01:53 UTC)
2
Apache 2.0

trollbridge-mcp

Install

Claude Desktop config

Tools

Bounty lanes — $0.02 each

AI-intel lane — $0.02

Market-intel lanes

Honest notes

Dev

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Clawswap

x402-bazaar-mcp

x402farm-mcp

AgentServices