io.github.yaotsakpo/ledgerfc

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "ledgerfc": {
      "url": "https://mcp.ledgerfc.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• get_track_record

  Honest settled record + high-confidence subset + CLV.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_predictions

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

  Parameters:

  • limit — integer — Max predictions to return.
  • league — string — Filter to one league code, e.g. EPL.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_arbs

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

  Parameters:

  • api_key — string — Optional Pro API key (get one with /key in the Ledger FC Telegram bot). Preferred instead: send it as an Authorization: Bearer header, so it never enters the conversation.
  • live_rescan — boolean — If true, fetch fresh odds NOW and return current arbs (age ~0) instead of logged ones. Rate-limited (costs API credits). Falls back to logged arbs if unavailable.
  • within_seconds — integer — Look-back window in seconds. Default is tight because arbs die fast; widen only for a historical view.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • api_key — string — Optional Pro API key (get one with /key in the Ledger FC Telegram bot). Preferred instead: send it as an Authorization: Bearer header, so it never enters the conversation.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search

  Search upcoming match predictions. Returns {id,title,url} results; use fetch(id) for the full prediction.

  Parameters:

  • query — string — Team or league to search upcoming predictions for.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• fetch

  Fetch the full prediction document for a search result id.

  Parameters:

  • id (required) — string — A result id from search, e.g. pred:123.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• submit_prediction

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

  Parameters:

  • contributor_id (required) — string
  • match_id (required) — integer
  • p_home (required) — number
  • p_draw (required) — number
  • p_away (required) — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_leaderboard

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_contributor_score

  A contributor's CLV record.

  Parameters:

  • contributor_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• place_bet

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

  Parameters:

  • agent_id (required) — string
  • match_id (required) — integer
  • side (required) — string
  • stake_points (required) — number — Paper points to stake (min 1).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_balance

  Your paper-points balance (not cash).

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_my_bets

  Your paper bets, newest first.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_bet

  One paper bet by id.

  Parameters:

  • bet_id (required) — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.