diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 93a8d07..9c7adcf 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -19,7 +19,7 @@ Smoke-test the built server via the MCP stdio handshake: (printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}\n{"jsonrpc":"2.0","method":"notifications/initialized"}\n{"jsonrpc":"2.0","id":2,"method":"tools/list"}\n'; sleep 2) | node dist/index.js 2>/dev/null ``` -Should return 20 tools including `blockrun_surf` and any new one you add. +Should return 19 tools including `blockrun_surf` and any new one you add. To test locally with Claude Code, point it at your dev build: diff --git a/README.md b/README.md index 26392c7..ae73968 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

Agents can't sign up for accounts. Agents can't enter credit cards.
Agents can only sign transactions.

-BlockRun MCP gives your agent 20 tools — markets, research, web search, images, video, on-chain data, and live Polymarket trading — paid per call.

+BlockRun MCP gives your agent 19 tools — markets, research, web search, images, video, on-chain data, and live Polymarket trading — paid per call.

Two ways to pay, same tools: a self-custody wallet (USDC on Solana or Base, no account needed) — or a BlockRun API key for teams that can't run wallets. Sign up at user.blockrun.ai →

Read the odds and place the bet, from one self-custody wallet.

@@ -52,7 +52,7 @@ claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest --- -> **BlockRun MCP** is an open-source [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude — and any MCP-compatible agent — 20 tools for real-time data and real actions: 76 LLMs, image & video generation, prediction-market data, live web/X search, on-chain queries across 40 chains, and **the ability to place real, USDC-settled bets on Polymarket**. +> **BlockRun MCP** is an open-source [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude — and any MCP-compatible agent — 19 tools for real-time data and real actions: 78 LLMs, image & video generation, prediction-market data, live web/X search, on-chain queries across 40 chains, and **the ability to place real, USDC-settled bets on Polymarket**. You pay per call, and you choose how. **Wallet mode** authenticates with a signature and settles each call in USDC via the [x402](https://x402.org) protocol — no account, no credit card, no subscription, on Solana or Base. **Account mode** authenticates with a BlockRun API key (`brk_live_…`) from [user.blockrun.ai](https://user.blockrun.ai) and bills prepaid credit at exact usage — for teams that can't hand a wallet to an agent. Same 20 tools either way. MIT licensed. @@ -68,7 +68,7 @@ Every other data integration was built for **human developers** — create an ac **Agents can't do any of that.** BlockRun MCP is built for the agent-first world: -- **One wallet, every source** — 20 tools behind a single self-custody wallet. No per-vendor signups. +- **One wallet, every source** — 19 tools behind a single self-custody wallet. No per-vendor signups. - **No API key required** — your wallet signature *is* authentication. (One is available at [user.blockrun.ai](https://user.blockrun.ai) for teams who need an invoice instead of a keypair.) - **No credit cards** — pay per request in USDC via [x402](https://x402.org), fractions of a cent each. - **Starts free** — the free tier (`blockrun_chat mode:"free"`, `blockrun_dex`, crypto `blockrun_price`, `blockrun_models`) costs $0. @@ -85,7 +85,7 @@ Every other data integration was built for **human developers** — create an ac | ------------------- | -------------------------------- | ------------------------- | ----------------------------------------- | | **Setup** | Account + API key *per vendor* | Account/key for 1 vendor | **Wallet auto-created — or one key for everything** | | **Payment** | Credit card, monthly minimums | Credit card / vendor plan | **USDC per-call via x402, or prepaid credit** | -| **Data sources** | One per integration | One vendor | **20 tools — LLMs, media, markets, chain**| +| **Data sources** | One per integration | One vendor | **19 tools — LLMs, media, markets, chain**| | **Place real bets** | Build it yourself | Rare | **Yes — Polymarket CLOB, confirm-gated** | | **Pay-chain** | — | — | **Solana + Base (or no chain at all)** | | **Agent budgets** | Manual | — | **Built-in per-agent delegation** | @@ -124,7 +124,7 @@ After BlockRun, it can. Each query costs fractions of a cent — billed from a l | Best for | Agents, solo devs, anything self-custody | Teams, companies, anyone who can't run a wallet | | Trade on Polymarket | ✅ | ❌ — needs a keypair to sign | -Both modes reach the same 20 tools. You can switch at any time; setting `BLOCKRUN_API_KEY` takes priority over a wallet, and unsetting it hands the wallet back. +Both modes reach the same 19 tools. You can switch at any time; setting `BLOCKRUN_API_KEY` takes priority over a wallet, and unsetting it hands the wallet back. ### 1. Install @@ -193,7 +193,7 @@ Expose a trimmed tool set so the client loads fewer schemas into context. Pass ` | Profile | Tools | |---------|-------| -| `full` *(default)* | everything (20 tools) | +| `full` *(default)* | everything (19 tools) | | `media` | `wallet` `models` `image` `video` `realface` `music` `speech` | | `trading` | `wallet` `price` `dex` `markets` `surf` `defi` `rpc` `polymarket_read` `polymarket` | | `research` | `wallet` `models` `chat` `search` `exa` `surf` | @@ -334,7 +334,7 @@ npx -y @blockrun/mcp@latest skills install --to ~/.codex/skills | Tool | Data source | Cost | |------|-------------|------| -| `blockrun_chat` | 76 LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K3, GLM, NVIDIA free tier, …) with `mode` tier routing | per token | +| `blockrun_chat` | 78 LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K3, GLM, NVIDIA free tier, …) with `mode` tier routing | per token | | `blockrun_image` | Generate: openai/gpt-image-2, gpt-image-1, google/nano-banana(-2/-pro), xai/grok-imagine-image(-pro), zai/cogview-4, bytedance/seedream-5-pro. Edit: img2img, inpaint, fusion. | $0.015–0.15 | | `blockrun_video` | Sora 2 + xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0-mini/2.0-fast/2.0/2.5 (720p + audio; 4K on 2.0, up to 30s on 2.5); RealFace asset → real-person video | $0.053–0.32/sec charged | | `blockrun_realface` | Enroll a real person (phone liveness) or AI character (Virtual Portrait) as a `ta_xxxx` asset for Seedance 2.0 / 2.0-fast / 2.0-mini video (not 2.5) | free; $0.01 to enroll | @@ -627,7 +627,7 @@ The server runs a non-blocking npm registry check at startup and prints an `Upda ## FAQ **What is BlockRun MCP?** -An open-source MCP server that gives Claude and other agents 20 tools for real-time data and real actions (trading, media, on-chain), paid per call — from a self-custody wallet or a BlockRun account key. +An open-source MCP server that gives Claude and other agents 19 tools for real-time data and real actions (trading, media, on-chain), paid per call — from a self-custody wallet or a BlockRun account key. **Do I need an API key or an account?** No. A wallet is auto-created locally on first run; you fund it with USDC and there are no signups, dashboards or keys to rotate. @@ -664,7 +664,7 @@ Both. Switch instantly with `blockrun_wallet action:"chain"`. A few media/paid t BlockRun is agent-native AI infrastructure — one wallet, x402 USDC micropayments, across every surface: -- **⚡ [ClawRouter](https://github.com/BlockRunAI/ClawRouter)** — the agent-native LLM router for OpenClaw. 76 models, <1ms local routing, USDC on Base & Solana. +- **⚡ [ClawRouter](https://github.com/BlockRunAI/ClawRouter)** — the agent-native LLM router for OpenClaw. 78 models, <1ms local routing, USDC on Base & Solana. - **🤖 [BRCC](https://blockrun.ai/brcc.md)** — BlockRun for Claude Code: smart routing + x402 payments, purpose-built for Claude Code. - **🐍 [ClawRouter-Hermes](https://github.com/BlockRunAI/ClawRouter-Hermes)** — Python plugin wiring NousResearch Hermes into the ClawRouter proxy. - **📚 [Docs](https://blockrun.ai/docs)** · **[Models & pricing](https://blockrun.ai/models)** — full SDKs, APIs, and the model catalogue. diff --git a/brand-numbers.json b/brand-numbers.json index 28b0d60..90d551d 100644 --- a/brand-numbers.json +++ b/brand-numbers.json @@ -2,17 +2,17 @@ "$schema": "https://blockrun.ai/brand/numbers.schema.json", "version": 1, "models": { - "chatVisible": 76, - "totalVisible": 100, - "free": 7, - "freeWithheld": 26, + "chatVisible": 78, + "totalVisible": 102, + "free": 6, + "freeWithheld": 27, "image": 9, "video": 8, "music": 1, "speech": 5, "soundfx": 1, - "withFallback": 34, - "withFallbackAllEntries": 73 + "withFallback": 33, + "withFallbackAllEntries": 74 }, "clawrouter": { "dimensions": 15, @@ -21,7 +21,7 @@ "aliases": 259 }, "mcp": { - "tools": 20, + "tools": 19, "contextTokens": 12900, "contextTokensTrading": 5554, "contextCutPct": 57 diff --git a/skills/blockrun/SKILL.md b/skills/blockrun/SKILL.md index 1fa4b64..c11b141 100644 --- a/skills/blockrun/SKILL.md +++ b/skills/blockrun/SKILL.md @@ -68,7 +68,7 @@ digits — an unmarked number is invisible to that check, which is exactly how t ## Getting a first call working -**Free, no wallet, no key.** 7 open-weight +**Free, no wallet, no key.** 6 open-weight chat models cost nothing. Use `blockrun_chat` with `mode: "free"` — the parameter is `mode`, not `routing`, and an unrecognised key is silently dropped, which lands you on the paid `balanced` tier instead. Calling the HTTP API directly, a free model needs no wallet and no