home / mcp / blockrun mcp server

BlockRun MCP Server

Provides unified access to 30+ AI models with a single wallet, pay-per-use pricing, and no API keys.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "blockrunai-blockrun-mcp": {
      "command": "npx",
      "args": [
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "0xabcdef...",
        "BASE_CHAIN_WALLET_KEY": "0x123456..."
      }
    }
  }
}

BlockRun MCP provides unified access to 30+ AI models with a single wallet, zero API keys, and pay-per-use pricing. You install once and then interact with multiple models through one command, simplifying setup and budgeting across providers.

How to use

You will install the MCP client, create a wallet automatically or use your own, fund it with a small amount of USDC, and then issue natural language prompts to any supported model. Use simple commands to ask questions, chat, or generate images, and let BlockRun select the right model or choose a specific model when you want full control.

Available tools

setup

Prepare the wallet and environment; generates or loads your wallet and prints the wallet address.

ask

Send a natural language prompt to a specific model and receive a response.

chat

Open an interactive chat with a model and continue a multi-turn conversation.

generate_image

Request an image to be generated by the selected model.

list_models

List available models and their pricing at a glance.

balance

Check the on-chain USDC balance of your wallet.

budget_check

Show the current session budget usage and remaining allowance.

smart

Choose a model set based on desired characteristics (fast, balanced, powerful, cheap, reasoning).

twitter_search

Fetch live data from X/Twitter based on your query.