MCP

Fantasy Tier exposes a hosted Model Context Protocol (MCP) server so AI agents can read league data and prepare (and optionally submit) Account Abstraction transactions — the same public API path the web app uses. Endpoint: https://www.fantasytier.com/mcp

Connect

Add the server to your MCP client (Cursor, Claude, and similar). Example config:

{
  "mcpServers": {
    "fantasy-tier": {
      "url": "https://www.fantasytier.com/mcp",
      "headers": {
        "X-Fantasy-Tier-Owner-Private-Key": "0xYOUR_AGENT_PRIVATE_KEY"
      }
    }
  }
}

Omit the header for reads and prepare-only writes. Sign outside the MCP session, then call relay.
With the header, set autoSubmit: true on prepare tools and pass an owner that matches that key’s address. The server signs and relays in-request (bring-your-own-key — the key is not stored).

Never commit private keys. Use a dedicated agent wallet with limited funds — not a personal cold wallet.

Write flow (Account Abstraction)

Call a prepare tool (create_squad, commit_squad_changes, and similar). The response includes a relayHint (intentId, userOperation, signingContext).
Sign the UserOp with the Safe owner, or use BYOK + autoSubmit: true when owner matches the header key’s address.
Call relay with the signed UserOp (skipped when autoSubmit already relayed).
Optionally poll get_user_operation_receipt.

Without a signer, prepare tools never sign. autoSubmit: true without the BYOK header returns an error telling the agent to sign outside and call relay.

Tools

Reads

Tool	Notes
`list_leagues`	Prefer before inventing addresses; defaults to official leagues
`get_league`	Rules, budget, and `boostersConfig` when known
`get_game_weeks`	Reality / results status
`get_game_week_results`	Proofs stripped; `includePlayerStats` opt-in
`get_leaderboard`	Overall or per game week; default page size 50
`list_squads`	Default page size 50; slim unless `detailed=true`
`get_squad`	Enriched lineup, boosters, budget, transfer allowance
`get_squad_game_week`	Formation snapshot for a game week
`get_squad_transfers`	Transfer history; optional `gameWeek`
`get_player_transfers`	Most transferred in/out for a game week
`search_players`	Name search — prefer over the full roster
`suggest_transfer_outs`	Valid outs for a given `playerIn`
`suggest_transfer_ins`	Ranked ins by `form`, `value`, or `fixture`
`suggest_squad`	Create-ready starters, backups, and boosters
`get_players`	Full roster (large) — prefer `search_players` or `suggest_squad`
`get_fixture`	Calendar or range-only

Prefer suggest_squad and search_players over get_players to keep payloads small for agents.

Writes / Account Abstraction

Tool	Notes
`validate_squad`	Dry-run composition check (no UserOp)
`create_squad`	Prepare create; optional `autoSubmit`
`commit_squad_changes`	Prepare transfers / boosters; optional `autoSubmit`
`join_league`	Prepare; optional `autoSubmit`
`abandon_league`	Prepare; optional `autoSubmit`
`claim_game_week_prize`	Prepare (needs merkle proof); optional `autoSubmit`
`set_squad_name`	Prepare; optional `autoSubmit`
`buy_credits`	Prepare; optional `autoSubmit`
`set_username`	Prepare; optional `autoSubmit`
`relay`	Submit an already-signed UserOp
`predict_wallet`	Predicted Safe address for an owner
`get_user_operation_receipt`	Bundler receipt after relay

Player refs accept names (preferred) or hex ids.

Example agent flows

Create a squad

get_league — sizes, budget, boostersConfig
suggest_squad — optional strategy (form default)
validate_squad — optional sanity check
create_squad — same lineup plus squadName / owner (and autoSubmit if using BYOK)

Make transfers

get_squad — lineup, boosters, budget, transfer allowance
suggest_transfer_ins (or search_players + suggest_transfer_outs)
commit_squad_changes with playerOuts, playerIns, and optional boosters

Each prepare with autoSubmit pays a bundler gas estimate — multi-step create + transfer loops are slower by design.

Overview

Game Modalities

Product

Developers

Guides

Support

Connect

Write flow (Account Abstraction)

Tools

Reads

Writes / Account Abstraction

Example agent flows

Create a squad

Make transfers

​Connect

​Write flow (Account Abstraction)

​Tools

​Reads

​Writes / Account Abstraction

​Example agent flows

​Create a squad

​Make transfers

Connect

Write flow (Account Abstraction)

Tools

Reads

Writes / Account Abstraction

Example agent flows

Create a squad

Make transfers