JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1027
  • Score
    100M100P100Q135330F
  • License MIT

BlockRun MCP Server - Give your AI agent web search, deep research, prediction markets, crypto data, X/Twitter intelligence. Paid via x402 micropayments.

Package Exports

  • @blockrun/mcp
  • @blockrun/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@blockrun/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@blockrun/mcp

Give your AI agent superpowers — web search, deep research, prediction markets, crypto data, X/Twitter intelligence.

npm version License: MIT

BlockRun MCP is a Model Context Protocol server that gives Claude Code (and any MCP-compatible agent) access to real-time web search, neural research, prediction markets, crypto DEX data, X/Twitter intelligence, and 41 LLM models — all paid via x402 micropayments in USDC. No API keys. No subscriptions. No accounts.

Quick Start

Option 1: Local (recommended — wallet auto-created, private key stays on your machine)

claude mcp add blockrun -- npx @blockrun/mcp

A wallet is automatically created on first use. Fund it with USDC on Base and every tool is immediately available.

Option 2: Hosted (zero install)

claude mcp add blockrun --transport http https://mcp.blockrun.ai/mcp

No Node.js. No npm. Works from any MCP client. Pass your wallet key via X-Wallet-Key header, or run blockrun_wallet for setup instructions.

Tools

Tool What it does Cost
blockrun_search Real-time web + news search ~$0.01/search
blockrun_exa Neural research (Exa) — finds papers, competitors, similar products $0.01/call
blockrun_twitter X/Twitter intelligence via Grok — search, trends, user analysis per token
blockrun_markets Prediction markets — Polymarket, Kalshi $0.001/call
blockrun_dex Real-time DEX prices and liquidity via DexScreener FREE
blockrun_image Image generation and editing (DALL-E 3, Flux) $0.02–0.08
blockrun_chat 41 AI models — get a second opinion or use a specialized model per token
blockrun_wallet Wallet balance, agent budgets, spending reports FREE
blockrun_models List all models with pricing FREE

Why BlockRun

Your AI agent already has an LLM. What it doesn't have: access to the live internet, research tools, market data, or a way to pay for services autonomously.

BlockRun fills this gap. Every tool call is a real micropayment — authorized locally by a wallet the agent controls. No API keys to manage, no vendor accounts to create. Just a wallet and USDC.

For multi-agent systems: parent agents can delegate spending limits to child agents by agent_id. When a child hits its limit, further calls are automatically blocked.

Funding Your Wallet

# Check your wallet address
blockrun_wallet action:"status"

Send USDC on Base network to your wallet address. $5 gets you started — that's ~500 Exa searches or ~50,000 Gemini Flash calls.

Method Steps
Coinbase Send → USDC → Select "Base" network → Paste address
Bridge bridge.base.org → Bridge USDC to Base

How Payments Work

Every request is paid via the x402 protocol — an open standard for machine-to-machine micropayments. Payments settle in USDC on Base (or Solana). Your wallet is created automatically on first use and stored locally at ~/.blockrun/.session. The private key is used only to sign payment authorizations locally — it is never transmitted to any server.

Configuration

Variable Description
BLOCKRUN_WALLET_KEY Bring your own private key (hex for Base, bs58 for Solana). Optional — a wallet is auto-generated if not set.

Wallet resolution order:

  1. BLOCKRUN_WALLET_KEY environment variable
  2. BASE_CHAIN_WALLET_KEY environment variable
  3. ~/.blockrun/.session (auto-created on first use)

License

MIT