Log inSubmit server
Blockrun MCP logo

Blockrun MCP

by blockrunai

Pay per call for LLMs, media generation, market data, blockchain RPC, research, and Polymarket actions through one MCP server.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Blockrun MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "blockrunai-blockrun-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp@latest"
      ],
      "env": {
        "BLOCKRUN_API_KEY": "YOUR_VALUE_HERE",
        "BLOCKRUN_BUDGET_LIMIT": "YOUR_VALUE_HERE",
        "BLOCKRUN_CONFIRM_SPEND": "YOUR_VALUE_HERE",
        "BLOCKRUN_KEYCHAIN": "YOUR_VALUE_HERE",
        "POLYMARKET_MAX_BET_USD": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

blockrunai/blockrun-mcp connects MCP-compatible agents to BlockRun’s paid APIs and wallet-based x402 payments. It exposes tools for model calls, web and market research, image, audio and video generation, blockchain data, remote sandboxes, phone services, and Polymarket trading. Wallet mode uses USDC on Solana or Base, while account mode uses a BlockRun API key and account credit. Reach for it when an agent needs multiple external services behind one MCP connection, especially with spending budgets or agent delegation.

Use cases

  • Call different LLMs for second opinions or specialized coding tasks
  • Research current topics with cited web and news results
  • Generate images, audio, music, and short videos from agent workflows
  • Query blockchain, DEX, DeFi, price, and prediction-market data
  • Delegate paid tasks to child agents with individual spending caps

Key features

  • Access to categorized LLMs with per-call pricing
  • USDC x402 payments on Solana or Base
  • BlockRun API key and account-credit payment mode
  • Image, speech, music, video, and face-asset tools
  • Blockchain RPC, market data, research, and sandbox tools
  • Wallet budgets and multi-agent spending controls

Tools19

What Blockrun MCP lets your agent do. Expand a tool for its parameters.

Verified live~12.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/21 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @blockrun/mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars392Stargazers on the source repository.
npm downloads3.6kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed19Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Blockrun MCP works

What blockrunai/blockrun-mcp does

blockrunai/blockrun-mcp gives MCP clients a single interface to a broad set of paid and free services. Its tools cover AI model access, model discovery, web search, neural research, image generation and editing, music, speech, video, real-face enrollment, market and price data, DEX data, DeFi fundamentals, blockchain RPC, remote code execution, phone operations, and Polymarket read and trading workflows.

The server supports two payment paths. In wallet mode, it creates or uses local wallets and settles eligible calls in USDC through x402. Solana and Base are supported, with one active payment chain at a time. In account mode, BLOCKRUN_API_KEY routes calls through BlockRun account credit instead of a local wallet or blockchain payment.

How it works

Install the npm package as an MCP process and connect it to an MCP client. Paid calls are charged per request, while selected capabilities such as free chat models, model listings, DEX data, and some price queries can be used without payment. blockrun_wallet reports balances, active-chain status, budgets, and agent spending allocations.

For multi-agent workflows, allocate a limit with delegate, pass the corresponding agent_id to that agent’s BlockRun calls, and use report to review spending. The wallet tool should also be used first when another BlockRun tool reports a payment or balance error.

Polymarket workflows separate discovery, read-only inspection, and trading. Use market data to find instruments, blockrun_polymarket_read for positions, orders, and previews, and blockrun_polymarket for confirmed operations such as buying, selling, redeeming, funding, or withdrawing.

Setup and configuration

The repository publishes an npm package and requires Node.js 20.19 or newer. A Claude Code installation command is:

Terminal
claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

Wallet mode creates a wallet on first use. blockrun_wallet can show funding instructions or produce a card-funded Coinbase Onramp link on Base. The active chain can be switched without editing environment variables or restarting.

Account mode uses BLOCKRUN_API_KEY and account credit managed through BlockRun. Optional controls include BLOCKRUN_BUDGET_LIMIT, BLOCKRUN_CONFIRM_SPEND, BLOCKRUN_KEYCHAIN, and POLYMARKET_MAX_BET_USD.

Tools and capabilities

  • Call categorized LLMs through blockrun_chat, including direct model selection and free models.
  • Compare available models and pricing with blockrun_models.
  • Search the live web with Grok or perform neural research through Exa.
  • Generate or edit images, music, speech, sound effects, and short videos.
  • Enroll real-face or virtual-portrait assets for supported video models.
  • Query prediction markets, crypto and other supported prices, DEX data, DeFi metrics, and raw blockchain RPC endpoints.
  • Run disposable BlockRun-hosted sandboxes with optional GPUs.
  • Provision phone numbers, inspect numbers, and place AI voice calls.
  • Read and trade Polymarket positions and orders, with confirmation required for funds-affecting actions.

Limitations and notes

Paid media and data calls consume wallet funds or account credit. Video and music operations are asynchronous and may take several minutes. Modal billing is based on the requested sandbox lifetime, including time not used. Polymarket trading uses real funds, and geographic or jurisdictional requirements remain the operator’s responsibility. Some capabilities are chain-specific: DefiLlama and Modal use Base, while native Anthropic chat models are Base-only. The project is MIT licensed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Blockrun MCP

blockrunai/blockrun-mcp is an MCP server that connects agents to BlockRun’s AI, research, media, market, blockchain, sandbox, phone, and Polymarket services. Its main tools include blockrun_chat, blockrun_search, blockrun_image, blockrun_video, blockrun_rpc, blockrun_markets, blockrun_wallet, and blockrun_polymarket, with wallet or API-key payment options.

Install it with `claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest`. The package runs with Node.js 20.19 or newer. Wallet mode creates a wallet on first use, while account mode uses the `BLOCKRUN_API_KEY` environment variable.

Yes, it works with Cursor. The server uses the Model Context Protocol and the project identifies Cursor among its supported MCP client environments. Configure Cursor to launch the npm package with `npx -y @blockrun/mcp@latest`, then choose wallet mode or provide a BlockRun API key.

It charges per call through either USDC wallet payments or BlockRun account credit. Wallet mode uses x402 settlement on Solana or Base, while account mode uses `BLOCKRUN_API_KEY`. Some tools and model modes are free, and wallet budgets can cap total or delegated-agent spending.

Yes, it can read Polymarket state and place confirmed trades. Use `blockrun_markets` to discover markets, `blockrun_polymarket_read` for positions, orders, and previews, and `blockrun_polymarket` for buying, selling, redeeming, funding, or withdrawing. Funds-affecting actions require confirmation.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBlockrun MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/blockrunai-blockrun-mcp?style=directory)](https://allmcps.com/mcp/blockrunai-blockrun-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/blockrunai-blockrun-mcp"><img src="https://allmcps.com/api/badge/blockrunai-blockrun-mcp?style=directory" alt="Blockrun MCP on AllMCPs" /></a>