@agentutility/mcp-statline 0.1.0

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 — model the rest of a match from the current score and time, no upstream feed required.
+
+**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. Models the rest of the game as a random walk on the score margin (final margin = current margin + a normal increment whose mean is the pregame edge accrued over the time left and whose std dev is the sport's final-margin volatility scaled by sqrt of time remaining), then returns each team's win probability as the normal CDF of the projected final margin, plus projected final margin, the 1-sigma swing still possible, and human-readable drivers. Pure deterministic compute, no upstream API. 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.0 · **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.0";
+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. Models the rest of the game as a random walk on the score margin (final margin = current margin + a normal increment whose mean is the pregame edge accrued over the time left and whose std dev is the sport's final-margin volatility scaled by sqrt of time remaining), then returns each team's win probability as the normal CDF of the projected final margin, plus projected final margin, the 1-sigma swing still possible, and human-readable drivers. Pure deterministic compute, no upstream API. 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.0",
+  "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"
+  }
+}