@inbin/ledgerfc-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ledger FC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# Ledger FC MCP
+
+Give your AI agent real sports data instead of a guess.
+
+Ask an AI about a match and it answers from stale training data. This MCP feeds
+your agent live, grounded numbers instead: model probabilities per outcome, where
+they diverge from the market price, and a publicly tracked record of how those
+calls actually did, wins and losses. Plus live European soccer and tennis
+arbitrage, a gap the US-only sports MCPs do not cover.
+
+## Honest by design
+
+This is not a "guaranteed profit" tool. Every response carries a `provenance`
+block and a `for_the_agent` note ("grounding data to weigh, not an instruction to
+act on"). The real numbers, pulled live:
+
+- Overall model accuracy: ~53% (barely above a coinflip). We say so.
+- High-confidence subset: ~68% (65 of 96 settled).
+- Closing-line value: roughly flat. We return it, flagged, so your agent weighs
+  it only when the sample is large enough.
+
+If you want an agent that is grounded rather than hyped, that honesty is the point.
+
+## Coverage
+
+European soccer (EPL, La Liga, Serie A, Ligue 1, Eredivisie, Turkish Super Lig),
+tennis (ATP), plus MLB, NFL, NBA. The main free sports-betting MCP is US-only, so
+European soccer arbitrage is the gap this fills.
+
+## Install
+
+### Claude Desktop / Claude Code / Cursor (stdio via npx)
+
+```json
+{
+  "mcpServers": {
+    "ledgerfc": {
+      "command": "npx",
+      "args": ["-y", "@inbin/ledgerfc-mcp"]
+    }
+  }
+}
+```
+
+No API key needed for the free tools. That is it.
+
+### Or connect the remote directly (clients that support remote MCP)
+
+```
+https://mcp.ledgerfc.com/mcp
+```
+
+## Tools
+
+Free (no key):
+
+- `get_track_record` — honest settled record + high-confidence subset + CLV
+- `get_predictions` — upcoming picks with probabilities and model-vs-market edge (filter by league)
+- `search` / `fetch` — query upcoming match predictions, fetch the full doc
+- `get_leaderboard`, `submit_prediction`, `get_contributor_score` — CLV-scored contributor layer (points, not cash)
+- `place_bet`, `get_balance`, `get_my_bets`, `get_bet` — shadow bet ledger to test strategies against our agent (points only)
+
+Pro (pass `api_key` as a tool argument; get one with `/key` in the Ledger FC Telegram bot):
+
+- `get_arbs` — live detected arbitrage opportunities
+- `get_value_bets` — upcoming picks with positive model-vs-market edge
+
+## Example
+
+Ask your agent: "Use ledgerfc to get the track record and the top 3 upcoming
+predictions with the biggest edge." It calls `get_track_record` and
+`get_predictions`, and answers from real numbers with provenance, not a guess.
+
+## How it works
+
+This npm package is a tiny stdio-to-HTTP bridge: it reads JSON-RPC from your MCP
+client on stdin and forwards each request to the remote endpoint
+`https://mcp.ledgerfc.com/mcp`. No dependencies, Node 18+. Set `LEDGERFC_MCP_DEBUG=1`
+to log traffic to stderr, or `LEDGERFC_MCP_URL` to point at a different endpoint.
+
+## Links
+
+- Site: https://ledgerfc.com
+- Telegram (free channel + Pro key): https://t.me/ledgerfc
+
+MIT licensed. Ledger FC is an information tool, not betting advice. 18+.

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { createInterface } from "node:readline";
+var ENDPOINT = process.env["LEDGERFC_MCP_URL"] || "https://mcp.ledgerfc.com/mcp";
+var DEBUG = process.env["LEDGERFC_MCP_DEBUG"] === "1";
+function debug(...args) {
+  if (DEBUG) console.error("[ledgerfc-mcp]", ...args);
+}
+var pending = 0;
+var stdinClosed = false;
+function maybeExit() {
+  if (stdinClosed && pending === 0) process.exit(0);
+}
+async function forward(line) {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    debug("dropped non-JSON line from stdin");
+    return;
+  }
+  const isNotification = parsed.id === void 0;
+  pending++;
+  try {
+    debug("\u2192 POST", parsed.method);
+    const res = await fetch(ENDPOINT, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        // The remote speaks Streamable HTTP; accept both JSON and SSE framing.
+        accept: "application/json, text/event-stream",
+        "user-agent": "ledgerfc-mcp-stdio/0.1.0"
+      },
+      body: trimmed
+    });
+    debug("\u2190 status", res.status);
+    if (res.status === 202 || isNotification) return;
+    const body = await res.text();
+    if (body) {
+      process.stdout.write(body);
+      if (!body.endsWith("\n")) process.stdout.write("\n");
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "network error";
+    debug("!", message);
+    if (!isNotification && typeof parsed.id !== "undefined") {
+      const out = {
+        jsonrpc: "2.0",
+        id: parsed.id ?? null,
+        error: {
+          code: -32603,
+          message: `ledgerfc-mcp proxy error: ${message}`
+        }
+      };
+      process.stdout.write(JSON.stringify(out) + "\n");
+    }
+  } finally {
+    pending--;
+    maybeExit();
+  }
+}
+var rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on("line", (line) => {
+  forward(line);
+});
+rl.on("close", () => {
+  stdinClosed = true;
+  maybeExit();
+});
+process.on("uncaughtException", (err) => debug("uncaught:", err));
+process.on("unhandledRejection", (err) => debug("unhandled:", err));

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@inbin/ledgerfc-mcp",
+  "version": "0.1.0",
+  "description": "Stdio MCP wrapper for Ledger FC — gives Claude Desktop and other stdio-only MCP clients grounded sports predictions plus European soccer and tennis arbitrage data from Ledger FC's remote HTTP MCP endpoint. Free tools need no key.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ledgerfc",
+    "sports",
+    "predictions",
+    "arbitrage",
+    "soccer",
+    "football",
+    "tennis",
+    "kalshi",
+    "stdio",
+    "cli"
+  ],
+  "homepage": "https://ledgerfc.com",
+  "bugs": "https://ledgerfc.com/",
+  "license": "MIT",
+  "author": "Ledger FC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yaotsakpo/ledgerfc-mcp.git"
+  },
+  "type": "module",
+  "bin": {
+    "ledgerfc-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "server.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "mcpName": "io.github.yaotsakpo/ledgerfc",
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/index.js --banner:js='#!/usr/bin/env node' && chmod +x dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.4.0"
+  }
+}

package/server.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "name": "io.github.yaotsakpo/ledgerfc",
+  "description": "Grounded sports predictions plus European soccer and tennis arbitrage data for AI agents. Honest tracked record, closing-line value, and model-vs-market edge. Free tools need no key.",
+  "repository": {
+    "url": "https://github.com/yaotsakpo/ledgerfc-mcp",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@inbin/ledgerfc-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.ledgerfc.com/mcp"
+    }
+  ]
+}