blockrun-mcp

@BlockRunAI/blockrun-mcp

Hosted

0 Stars 7 次浏览 BlockRunAI 更新于 2026-08-23

BlockRun MCP Server - Access 30+ AI models via x402 micropayments. No API keys needed.

开发者工具

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "@blockrun/mcp": {
      "args": [
        "@blockrun/mcp@0.2.2"
      ],
      "command": "npx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

@blockrun/mcp

# The Problem

Want to use GPT-5, Gemini, or DeepSeek in Claude Code? Today you need to:

Create accounts with 5+ AI providers
Manage 5+ API keys and billing systems
Pay $20-100/month minimums per provider
Configure each provider separately

That's too much friction.

# The Solution

BlockRun MCP gives you access to 30+ AI models with:

Zero API keys - No accounts needed with OpenAI, Google, etc.
One wallet - Single USDC balance for all providers
Pay-per-use - No minimums, $5 gets you started
One command - Install and go

claude mcp add blockrun npx @blockrun/mcp

Alternative: Prefer Python? Try the BlockRun Skill (pip install blockrun-llm) - same features, different integration style.

# Quick Start

# # 1. Install

claude mcp add blockrun npx @blockrun/mcp

A wallet is automatically created for you.

# # 2. Get Your Wallet Address

You: blockrun setup

Claude: Your wallet address is 0x...
        Send USDC on Base network to fund it.

# # 3. Fund Your Wallet

Send USDC to your wallet address on Base network. Even $5 gets you hundreds of requests.

# # 4. Start Using

Just ask naturally:

You: blockrun ask GPT-5 to explain quantum computing

You: blockrun chat with Claude Opus about this error

You: blockrun generate an image of a mountain sunset

# Usage Examples

# # Chat with Any Model

blockrun ask GPT-5 what causes aurora borealis

blockrun chat with Claude Opus about optimizing this algorithm

blockrun ask Gemini Pro to review this code for security issues

Popular Models:

openai/gpt-5.2 - Most capable OpenAI model
anthropic/claude-opus-4 - Best for complex reasoning
anthropic/claude-sonnet-4 - Fast & capable (recommended)
google/gemini-2.5-pro - Great for long context (1M tokens)
deepseek/deepseek-chat - Very affordable

# # Smart Model Selection

Let BlockRun pick the best model for your needs:

blockrun smart fast: what's 2+2

blockrun smart powerful: analyze this complex codebase

blockrun smart cheap: summarize this text

# # Generate Images

blockrun generate an image of a cyberpunk cityscape

blockrun create a watercolor painting of mountains

# # List Available Models

blockrun list models

blockrun show OpenAI models with pricing

# # Real-Time X/Twitter Search

Get live data from X/Twitter using Grok's real-time search:

blockrun twitter: what is @elonmusk posting about today

blockrun twitter: trending AI news

blockrun twitter: reactions to [recent event]

# # Wallet & Balance

blockrun setup          #  First-time setup instructions
blockrun wallet         #  Check your wallet address
blockrun balance        #  Check on-chain USDC balance

# # Budget Management

Control your session spending:

blockrun budget check              #  View current spending
blockrun budget set $1.00          #  Set $1.00 limit
blockrun budget clear              #  Remove limit

# Supported Models & Pricing

# # Chat Models

| Provider | Models | Input Price | Output Price |
|- -- -- -- -- -|- -- -- -- -|- -- -- -- -- -- --|- -- -- -- -- -- -- -|
| OpenAI | GPT-5.2, GPT-5-mini, GPT-4o, o3, o1 | $0.15 - $21/M | $0.60 - $84/M |
| Anthropic | Claude Opus 4, Sonnet 4, Haiku | $0.25 - $15/M | $1.25 - $75/M |
| Google | Gemini 3 Pro, 2.5 Pro/Flash | Free - $2.50/M | Free - $15/M |
| DeepSeek | V3.2, Reasoner | $0.14 - $0.55/M | $0.28 - $2.19/M |
| xAI | Grok 3, Grok 3 Mini | $3 - $5/M | $15 - $25/M |

M = million tokens. Prices in USD.

# # Image Models

| Model | Price per Image |
|- -- -- --|- -- -- -- -- -- -- -- --|
| DALL-E 3 (Standard) | $0.04 |
| DALL-E 3 (HD) | $0.08 |
| Flux Schnell | $0.02 |

# # Cost Examples

$5 gets you approximately:

50,000 Gemini Flash requests, OR
1,600 Claude Sonnet requests, OR
1,000 GPT-4o requests, OR
125 DALL-E 3 images

# Wallet Management

# # Auto-Generated Wallet

When you first use BlockRun MCP, a wallet is automatically created and saved to:

~/.blockrun/.session

This wallet is:

Created locally on your machine
Never transmitted to any server
Used only for signing payment authorizations
Persistent across sessions

# # Using Your Own Wallet

If you prefer to use an existing wallet:

#  Option 1: Environment variable
export BLOCKRUN_WALLET_KEY=0x...

#  Option 2: Add with Claude Code
claude mcp add blockrun npx @blockrun/mcp - -env BLOCKRUN_WALLET_KEY=0x...

# # Wallet Priority

Environment variable BLOCKRUN_WALLET_KEY
Environment variable BASE_CHAIN_WALLET_KEY
File at ~/.blockrun/.session
Auto-generate new wallet (saved to file)

# How Payment Works

┌─────────────────────────────────────────────────────────────┐
│  1. You send a request (e.g., chat with GPT-5)              │
│                          ↓                                  │
│  2. BlockRun calculates cost based on tokens                │
│                          ↓                                  │
│  3. Your wallet signs a payment authorization LOCALLY       │
│     (private key NEVER leaves your machine)                 │
│                          ↓                                  │
│  4. Payment settles on Base network via USDC                │
│                          ↓                                  │
│  5. You receive your AI response                            │
└─────────────────────────────────────────────────────────────┘

Security Guarantees:

Private key is used ONLY for local signing
Key is NEVER transmitted to any server
Same security model as MetaMask transactions
You can verify all transactions on Basescan

# Comparison with Alternatives

# # vs claude-code-proxy

# # vs gemini-mcp

# # vs Direct API Keys

# Troubleshooting

# # "Payment was rejected"

Your wallet needs funding. Say blockrun setup to get your address and funding instructions.

# # "Wallet key required"

The MCP couldn't find or create a wallet. Check that ~/.blockrun/ directory is writable.

# # Model not responding

Some models have rate limits. Try blockrun smart cheap or blockrun smart fast to use alternative models.

# # Check wallet balance

Say blockrun balance to check your on-chain USDC balance, or visit: https://basescan.org/address/YOUR_ADDRESS

# # Budget limit reached

If you've set a session budget and hit the limit, use blockrun budget clear to remove it or blockrun budget set $X to increase it.

# Configuration

# # Claude Code Setup

#  Basic (recommended)
claude mcp add blockrun npx @blockrun/mcp

#  With explicit wallet
claude mcp add blockrun npx @blockrun/mcp - -env BLOCKRUN_WALLET_KEY=0x...

#  Project-specific
claude mcp add blockrun - -scope project npx @blockrun/mcp

#  User-wide (all projects)
claude mcp add blockrun - -scope user npx @blockrun/mcp

# # Environment Variables

# Development

#  Clone
git clone https://github.com/blockrunai/blockrun-mcp
cd blockrun-mcp

#  Install dependencies
npm install

#  Development mode (auto-reload)
npm run dev

#  Build for production
npm run build

#  Test locally
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

# Links

Website: blockrun.ai
Documentation: GitHub Docs
Pricing: blockrun.ai/pricing
GitHub: github.com/blockrunai
Twitter: @BlockRunAI

# Support

Issues: GitHub Issues
Telegram: Join our Telegram
Email: hello@blockrun.ai

# License

MIT

查看源码项目主页