@blockrun/mcp 0.6.2 → 0.6.4

package/README.md

@@ -1,31 +1,14 @@
 # @blockrun/mcp
 
-**Give your AI agent superpowers — web search, deep research, prediction markets, crypto data, X/Twitter intelligence.**
+**Live data for AI agents — search, research, markets, crypto, X/Twitter.**
 
-[![npm version](https://img.shields.io/npm/v/@blockrun/mcp)](https://www.npmjs.com/package/@blockrun/mcp)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-
-BlockRun MCP gives your AI agent access to live data it can't get on its own — real-time web search, neural research, prediction markets, crypto DEX prices, and X/Twitter intelligence. 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)
+[![npm](https://img.shields.io/npm/v/@blockrun/mcp)](https://www.npmjs.com/package/@blockrun/mcp)
 
 ```bash
-claude mcp add blockrun -- npx @blockrun/mcp
+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)
-
-```bash
-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.
+Wallet auto-created. Fund with USDC on Base. Done.
 
 ---
 
@@ -33,74 +16,43 @@ No Node.js. No npm. Works from any MCP client. Pass your wallet key via `X-Walle
 
 | 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` | Second opinion from another model (GPT, Gemini, DeepSeek, etc.) | 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.
+| `blockrun_search` | Web + news search | ~$0.01 |
+| `blockrun_exa` | Neural research — papers, competitors, similar products | $0.01 |
+| `blockrun_twitter` | X/Twitter via Grok — trends, sentiment, @handles | per token |
+| `blockrun_markets` | Prediction markets — Polymarket, Kalshi | $0.001 |
+| `blockrun_dex` | DEX prices via DexScreener | free |
+| `blockrun_image` | Image gen (DALL-E 3, Flux) | $0.02-0.08 |
+| `blockrun_chat` | Second opinion from GPT, Gemini, DeepSeek, etc. | per token |
+| `blockrun_wallet` | Balance, budgets, spending | free |
+| `blockrun_models` | List models + pricing | free |
 
 ---
 
-## Funding Your Wallet
+## Fund 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.
+Run `blockrun_wallet` to see your address, then send USDC on Base. $5 = ~500 Exa searches.
 
-| Method | Steps |
-|--------|-------|
-| Coinbase | Send → USDC → Select "Base" network → Paste address |
-| Bridge | [bridge.base.org](https://bridge.base.org) → Bridge USDC to Base |
+| Method | How |
+|--------|-----|
+| Coinbase | Send → USDC → Base network → paste address |
+| Bridge | [bridge.base.org](https://bridge.base.org) |
 
 ---
 
-## How Payments Work
+## How It Works
 
-Every request is paid via the [x402 protocol](https://x402.org) — 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.
+Pay-per-call via [x402](https://x402.org) micropayments in USDC. Wallet stored locally at `~/.blockrun/.session`. Private key never leaves your machine.
 
----
-
-## 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)
+For multi-agent systems: delegate budgets to child agents with `agent_id`. Auto-blocked when budget runs out.
 
 ---
 
-## Links
+## Hosted (no install)
 
-- **Website:** [blockrun.ai](https://blockrun.ai)
-- **npm:** [@blockrun/mcp](https://www.npmjs.com/package/@blockrun/mcp)
-- **Hosted MCP:** [mcp.blockrun.ai/mcp](https://mcp.blockrun.ai/mcp)
-- **GitHub:** [github.com/blockrunai/blockrun-mcp](https://github.com/blockrunai/blockrun-mcp)
-- **Telegram:** [t.me/+mroQv4-4hGgzOGUx](https://t.me/+mroQv4-4hGgzOGUx)
-- **X:** [@BlockRunAI](https://x.com/BlockRunAI)
+```bash
+claude mcp add --transport http blockrun https://mcp.blockrun.ai/mcp
+```
 
 ---
 
-## License
-
-MIT
+[blockrun.ai](https://blockrun.ai) · [npm](https://www.npmjs.com/package/@blockrun/mcp) · [github](https://github.com/blockrunai/blockrun-mcp) · [@BlockRunAI](https://x.com/BlockRunAI)

package/dist/index.js

@@ -870,8 +870,8 @@ Example paths:
 Pricing: $0.001/GET, $0.005/POST`,
       inputSchema: {
         path: z8.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14'"),
-        params: z8.record(z8.string()).optional().describe("Query parameters for GET requests"),
-        body: z8.record(z8.unknown()).optional().describe("JSON body for POST queries (triggers pmQuery)")
+        params: z8.record(z8.string(), z8.string()).optional().describe("Query parameters for GET requests"),
+        body: z8.any().optional().describe("JSON body for POST queries (triggers pmQuery)")
       }
     },
     async ({ path: path2, params, body }) => {
@@ -1026,12 +1026,12 @@ function initializeMcpServer(server) {
 async function main() {
   const server = new McpServer({
     name: "blockrun-mcp",
-    version: "0.6.1"
+    version: "0.6.3"
   });
   initializeMcpServer(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("BlockRun MCP Server started (v0.6.1) \u2014 stdio transport");
+  console.error("BlockRun MCP Server started (v0.6.3) \u2014 stdio transport");
 }
 main().catch((error) => {
   console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "mcpName": "io.github.BlockRunAI/blockrun-mcp",
   "description": "BlockRun MCP Server - Give your AI agent web search, deep research, prediction markets, crypto data, X/Twitter intelligence. Paid via x402 micropayments.",
   "type": "module",