Ledgerfc

io.github.yaotsakpoPublished by GitHub account yaotsakpov0.3.0Updated Oct 24, 2026

Grounded sports predictions plus European soccer and tennis arbitrage data for AI agents.

The publisher's own server: Inbin agent email

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Ledger FC MCP gives an AI assistant grounded sports predictions, model-vs-market edge, track records and European soccer and tennis arbitrage data.

What you can do
Retrieve settled track record, high-confidence subset and closing-line value, and list upcoming predictions with probabilities and model-vs-market edge, filterable by league and searchable by match with full prediction documents. Submit predictions and view contributor leaderboards and CLV scores. Place and review paper-points bets and check a paper balance. With a Pro key, list live arbitrage opportunities and positive-edge value bets.
When to use it
Use it when an assistant should answer sports match questions from live, sourced numbers rather than stale training data, or when you want to compare model probabilities against market prices for European soccer, tennis, MLB, NFL or NBA. The paper-bet ledger suits testing strategies without money.
Requirements
Runs as a remote endpoint or as a local npm package via npx, which needs Node.js 18 or later and network access to the remote endpoint. Free tools need no key. Pro tools need a Pro key, supplied as the LEDGERFC_API_KEY environment variable or an Authorization Bearer header, or passed as an api_key argument.
Before you install
Pro tools require a paid-tier key obtained through the provider's Telegram bot. Betting tools are paper points only, not cash, and the README states the tool is information, not betting advice, for adults. Submitting predictions and placing paper bets write data to your account. The local package forwards all requests to the provider's remote endpoint.

Installation

In SourceWeft

  1. Open Ledgerfc in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.yaotsakpo%2Fledgerfc/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ledgerfc": {
      "type": "http",
      "url": "https://mcp.ledgerfc.com/mcp"
    }
  }
}

README

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.

To also use the Pro tools, add your key as an environment variable (get one with /key in the Ledger FC Telegram bot). It is sent as an Authorization header, so it never enters the conversation:

json
{  "mcpServers": {    "ledgerfc": {      "command": "npx",      "args": ["-y", "@inbin/ledgerfc-mcp"],      "env": { "LEDGERFC_API_KEY": "your-pro-key" }    }  }}

Or connect the remote directly (clients that support remote MCP)

https://mcp.ledgerfc.com/mcp

For Pro tools, send the key as an Authorization: Bearer <key> header.

Tools

Free (no key):

  • get_track_record: honest settled record plus high-confidence subset and 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 (set LEDGERFC_API_KEY, or 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

MIT licensed. Ledger FC is an information tool, not betting advice. 18+.

Source: README.md at commit d19e9c0

Tools

13

get_track_record

Honest settled record + high-confidence subset + CLV.

Takes no parameters.

get_predictions

Upcoming predictions with probabilities and model-vs-market edge.

Parameterslimitleague

get_arbs

PRO: recently detected live arbitrage opportunities. Needs a Pro key, via an Authorization: Bearer header (preferred) or the api_key argument.

Parametersapi_keylive_rescanwithin_seconds

get_value_bets

PRO: upcoming picks with positive model-vs-market edge. Needs a Pro key, via an Authorization: Bearer header (preferred) or the api_key argument.

Parametersapi_key

fetch

Fetch the full prediction document for a search result id.

Parametersidrequired

submit_prediction

Submit a prediction to be scored by CLV (shadow/points).

Parametersp_awayrequiredp_drawrequiredp_homerequiredmatch_idrequiredcontributor_idrequired

get_leaderboard

Contributors ranked by CLV (reputation points, not cash).

Takes no parameters.

get_contributor_score

A contributor's CLV record.

Parameterscontributor_idrequired

place_bet

Place a paper bet against our agent's prediction (points only).

Parameterssiderequiredagent_idrequiredmatch_idrequiredstake_pointsrequired

get_balance

Your paper-points balance (not cash).

Parametersagent_idrequired

get_my_bets

Your paper bets, newest first.

Parametersagent_idrequired

get_bet

One paper bet by id.

Parametersbet_idrequired

Version history

1
  1. v0.3.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Inbin integrations