@agentutility/mcp-statline 0.1.1

package/README.md

@@ -0,0 +1,74 @@
+# @agentutility/mcp-statline
+
+> Sports and stats math, per call.
+
+Live win probability and the analytics around a game — from the current score and time, in one call.
+
+**Pricing:** pay-per-call in USDC on Base. No subscriptions, no API keys. See per-tool prices below.
+
+## Install — Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "agentutility-statline": {
+      "command": "npx",
+      "args": ["-y", "@agentutility/mcp-statline"],
+      "env": { "X402_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HEX" }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. 1 tools appear in the tool palette.
+
+## Install — Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "agentutility-statline": {
+      "command": "npx",
+      "args": ["-y", "@agentutility/mcp-statline"],
+      "env": { "X402_PRIVATE_KEY": "0x..." }
+    }
+  }
+}
+```
+
+## Funding
+
+Send any amount of **USDC on Base mainnet** to the address derived from your `X402_PRIVATE_KEY`. The MCP server uses it to pay for tool calls automatically.
+
+USDC on Base contract: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
+
+## Tools (1)
+
+| Tool | Description |
+|---|---|
+| `win-prob` | (0.003 USDC/call) Live sports win probability API / in-game win probability calculator / NFL NBA MLB NHL soccer win chance from current score and time remaining. Returns each team's win probability, the projected final margin, the size of the swing still possible, and human-readable drivers. Built-in scoring volatility for NFL/NCAAF/NBA/NCAAB/WNBA/MLB/NHL/soccer; override scoring_std for any sport. Statistical estimate, not betting advice. |
+
+## How it works
+
+1. Agent calls a tool (e.g. `win-prob`).
+2. MCP server POSTs to `https://x402.agentutility.ai/win-prob`.
+3. The endpoint responds **HTTP 402** with payment instructions.
+4. The MCP server signs an EIP-3009 USDC transfer authorization with `X402_PRIVATE_KEY` and retries.
+5. CDP facilitator settles on Base.
+6. The endpoint returns the actual response.
+
+The agent never sees the payment flow — it just gets the result.
+
+## Links
+
+- Cluster overview: https://agentutility.ai/statline/
+- All MCP packages: https://mcp.agentutility.ai/
+- Source: https://github.com/rooz21/x402/tree/main/packages/mcp-statline
+
+---
+
+**Version:** 0.1.1 · **License:** MIT

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * @agentutility/mcp-<cluster> — stdio MCP server exposing the cluster's
+ * x402-paid endpoints as MCP tools. Forwards every CallToolRequest to
+ * x402.agentutility.ai, where @x402/fetch handles 402 → payment → retry
+ * using the agent's own wallet (X402_PRIVATE_KEY env var).
+ *
+ * Boilerplate is single-sourced at packages/_template/src/index.ts and
+ * copied verbatim into each packages/mcp-<cluster>/src/index.ts by
+ * scripts/generate-mcp-clusters.mjs. The codegen also writes a matching
+ * tools.generated.ts so this file imports CLUSTER_SLUG + VERSION + TOOLS
+ * rather than hard-coding.
+ *
+ * Required env: X402_PRIVATE_KEY (hex EVM key, USDC on Base).
+ * Optional env: X402_BASE_URL (default https://x402.agentutility.ai)
+ *               X402_RPC_URL  (default https://mainnet.base.org)
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
+import { ExactEvmScheme, toClientEvmSigner } from "@x402/evm";
+import { privateKeyToAccount } from "viem/accounts";
+import { createPublicClient, http } from "viem";
+import { base } from "viem/chains";
+import { TOOLS, CLUSTER_SLUG, VERSION } from "./tools.generated.js";
+const BASE_URL = (process.env.X402_BASE_URL || "https://x402.agentutility.ai").replace(/\/$/, "");
+const RPC_URL = process.env.X402_RPC_URL || "https://mainnet.base.org";
+const PK = process.env.X402_PRIVATE_KEY;
+if (!PK) {
+    console.error(`[@agentutility/mcp-${CLUSTER_SLUG}] FATAL: X402_PRIVATE_KEY env var is required.`);
+    console.error("Set it to a hex-encoded EVM private key with USDC balance on Base (chain 8453).");
+    console.error("USDC on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+    process.exit(1);
+}
+const account = privateKeyToAccount((PK.startsWith("0x") ? PK : `0x${PK}`));
+const publicClient = createPublicClient({
+    chain: base,
+    transport: http(RPC_URL),
+});
+const signer = toClientEvmSigner(account, publicClient);
+const client = new x402Client().register("eip155:8453", new ExactEvmScheme(signer));
+const paidFetch = wrapFetchWithPayment(fetch, client);
+async function trackedFetch(url, init) {
+    const headers = new Headers(init?.headers);
+    headers.set("X-Agent-Channel", `mcp-stdio-${CLUSTER_SLUG}`);
+    headers.set("X-Agent-Id", "47167");
+    if (!headers.has("User-Agent")) {
+        headers.set("User-Agent", `agentutility-mcp/${CLUSTER_SLUG}/${VERSION}`);
+    }
+    return paidFetch(url, { ...init, headers });
+}
+const server = new Server({ name: `agentutility-${CLUSTER_SLUG}`, version: VERSION }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS.map((t) => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.input_schema,
+    })),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const name = req.params.name;
+    const tool = TOOLS.find((t) => t.name === name);
+    if (!tool) {
+        return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+    }
+    try {
+        const res = await trackedFetch(`${BASE_URL}/${tool.http_name}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(req.params.arguments ?? {}),
+        });
+        const body = await res.text();
+        if (!res.ok) {
+            return { content: [{ type: "text", text: `HTTP ${res.status}: ${body}` }], isError: true };
+        }
+        return { content: [{ type: "text", text: body }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `tool call failed: ${err instanceof Error ? err.message : String(err)}` }],
+            isError: true,
+        };
+    }
+});
+await server.connect(new StdioServerTransport());

package/dist/tools.generated.js

@@ -0,0 +1,60 @@
+/** Auto-generated by scripts/generate-mcp-clusters.mjs. Do not edit by hand. */
+export const CLUSTER_SLUG = "statline";
+export const VERSION = "0.1.1";
+export const TOOLS = [
+    {
+        "name": "win-prob",
+        "http_name": "win-prob",
+        "description": "(0.003 USDC/call) Live sports win probability API / in-game win probability calculator / NFL NBA MLB NHL soccer win chance from current score and time remaining. Returns each team's win probability, the projected final margin, the size of the swing still possible, and human-readable drivers. Built-in scoring volatility for NFL/NCAAF/NBA/NCAAB/WNBA/MLB/NHL/soccer; override scoring_std for any sport. Statistical estimate, not betting advice.",
+        "method": "POST",
+        "input_schema": {
+            "type": "object",
+            "properties": {
+                "sport": {
+                    "type": "string",
+                    "description": "Sport/league: nfl, ncaaf, nba, ncaab, wnba, mlb, nhl, soccer/epl/mls. Case-insensitive. Use 'generic' with scoring_std for anything else."
+                },
+                "score_a": {
+                    "type": "number",
+                    "description": "Current score of team A (the reference team)."
+                },
+                "score_b": {
+                    "type": "number",
+                    "description": "Current score of team B."
+                },
+                "time_remaining_fraction": {
+                    "type": "number",
+                    "description": "Fraction of the game still to play, 0-1. Provide this OR minutes_remaining + minutes_total."
+                },
+                "minutes_remaining": {
+                    "type": "number",
+                    "description": "Game minutes left (alternative to time_remaining_fraction)."
+                },
+                "minutes_total": {
+                    "type": "number",
+                    "description": "Total game minutes (e.g. 48 NBA, 60 NFL/NHL)."
+                },
+                "pregame_spread": {
+                    "type": "number",
+                    "description": "Optional expected FINAL margin for team A at kickoff (positive = A favored). Default 0 (even)."
+                },
+                "scoring_std": {
+                    "type": "number",
+                    "description": "Optional override of the final-margin standard deviation; required for sports without a built-in default."
+                },
+                "team_a_name": {
+                    "type": "string",
+                    "description": "Optional label for team A."
+                },
+                "team_b_name": {
+                    "type": "string",
+                    "description": "Optional label for team B."
+                }
+            },
+            "required": [
+                "score_a",
+                "score_b"
+            ]
+        }
+    }
+];

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@agentutility/mcp-statline",
+  "version": "0.1.1",
+  "description": "MCP server for the @agentutility statline cluster — pay-per-call x402 tools, no API keys, USDC on Base.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "agentutility-mcp-statline": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rooz21/x402",
+    "directory": "packages/mcp-statline"
+  },
+  "homepage": "https://mcp.agentutility.ai/statline/",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "x402",
+    "agentutility",
+    "agent-tools",
+    "statline"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@x402/fetch": "^2.12.0",
+    "@x402/evm": "^2.12.0",
+    "viem": "^2.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}