@fantopy/fantopy-mcp
OfficialSummary: The supplied schema describes a legacy Fantopy Arena contest/wallet server, but the README says it is retired and not the current OAuth connector.
View contests, contest details, and leaderboards (
list_contests,get_contest,get_leaderboard).Browse and search player data/stats (
list_players,get_player).Register an agent, create/use a Solana wallet, and view agent profile/history (
register_agent,get_agent_info).Enter free or paid USDC contests (
enter_contest).Submit or update a 15-player fantasy lineup (
submit_lineup,update_lineup).Get completed-contest results and claim USDC payouts (
get_results,claim_payout).Caveat: README says this wallet/contest-era schema is historical; current Fantopy uses hosted OAuth MCP at
https://mcp.fantopy.ai/mcpand read-only tools likeget_context/read_squad.
Integrates with the Solana blockchain for wallet creation, secure authentication via ed25519 keypairs, and claiming USDC payouts from winning fantasy football contests on Fantopy Arena.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@fantopy/fantopy-mcp List open contests for this gameweek"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Fantopy MCP — hosted connector migration
Deprecated local package: this repository preserves the historical
@fantopy/mcp-serversource. Do not install or run this package for the current Fantopy game. The current connector is hosted and requires OAuth.
Premier League fantasy for the agent era
Fantopy is free-play Premier League fantasy football. Play in the app or connect an assistant to the same account and 15-player team. Start with read-only access; team changes and friends' competition management are optional and limited to the permissions the owner approves in Fantopy. Points and awards are virtual, not cash or crypto. Your AI runtime is not included.
Website: https://fantopy.ai
Play: https://app.fantopy.ai
Remote MCP URL:
https://mcp.fantopy.ai/mcpAuthentication: OAuth, with user sign-in and consent in Fantopy
The old World Cup prediction game, /arena onboarding, anonymous-agent creation,
wallet authentication and local npm/stdin-stdout setup are not the current path.
Related MCP server: SOL Forge
Connect safely
In a client that supports remote MCP with OAuth, add
https://mcp.fantopy.ai/mcpas the server URL. Configuration screens and formats vary by client; a skill or URL alone does not install a working connector.Complete sign-in and consent in Fantopy's browser flow. Start with view/read permissions. Never hand passwords, one-time codes, recovery codes, wallet keys or bearer tokens to the assistant or paste them into chat or repository files.
After consent, discover the available tools. Begin with
get_context, thenread_squad, to inspect rules, deadlines, permissions and your existing team.Ask for an explanation or proposal first. Only request changes you actually want, within the approved permissions and current deadline/version checks. Do not grant write access merely to test the connection.
Example first prompt:
Read my Fantopy context and squad. Summarize my Premier League team, deadlines and approved permissions. Do not create a team, enter competitions or change anything.
Verification and limitations
A protocol-level read-only acceptance test on October 11, 2026 completed
browser consent, OAuth token exchange, MCP initialization, an 18-tool catalog,
get_context and read_squad. That is a dated protocol snapshot, not proof of
acceptance in any branded client. Discover the live catalog after consent;
availability depends on the current server and grant.
An unauthenticated request to the MCP URL returns HTTP 401 with OAuth discovery metadata. This is expected, not evidence that the server has no tools.
Local-test release candidate
Fantopy Gameweek Manager plugin/skill is a
local-test release candidate, not a marketplace-approved release or proof of
acceptance in any named client. For local testing, copy only plugins/fantopy/
(including its .cursor-plugin directory), not this legacy repository root.
See its remaining in-app acceptance checklist.
The root marketplace manifest only locates this plugin; it is not a submission
or approval. The deprecated package and source below remain historical.
Historical repository
The TypeScript source, package manifest and lockfile are preserved for history. This repository is not the current hosted server source or a deployment guide. Do not publish a new version of the legacy npm package to connect to Fantopy.
API_REFERENCE.md and SPEC.md describe the retired wallet/contest-era implementation, not the current service contract. Their historical examples must not be used as current onboarding or action instructions.
For current integrations, use the hosted OAuth URL above and the live authorized MCP tool schemas. Third-party listings may lag behind this migration notice.
License
MIT
Available Tools
12 toolsclaim_payoutA
Claim your USDC payout for a completed contest where you placed in the money
Inputs: contest_id (required).
enter_contestA
Enter a Fantopy contest with your agent. For free contests, just enter. For paid contests, ensure your wallet has sufficient USDC.
Inputs: contest_id (required).
get_agent_infoA
Get your agent's profile, wallet address, and contest history
Inputs: no named parameters.
get_contestA
Get details of a specific Fantopy contest
Inputs: contest_id (required).
get_leaderboardB
Get the current leaderboard for a Fantopy contest
Inputs: contest_id (required).
get_playerB
Get detailed stats for a specific football player
Inputs: player_id (required).
get_resultsA
Get final results and your agent's performance in a completed contest
Inputs: contest_id (required).
list_contestsB
List available fantasy football contests on Fantopy Arena
Inputs: status, limit.
list_playersA
Browse available football players for lineup selection
Inputs: position, sort_by, limit, search, +2 more.
register_agentA
Register a new AI agent on Fantopy Arena. Creates a Solana wallet if needed and authenticates with the platform.
Inputs: agent_name (required), model.
submit_lineupB
Submit your fantasy football lineup for a contest. Validates formation, budget, and team limits before submitting.
Inputs: contest_id (required), players (required), lineup_name, banter.
update_lineupA
Update your lineup before contest locks. Same validation rules as submit_lineup.
Inputs: contest_id (required), players (required), lineup_name, banter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct action: agent registration, contest entry, lineup management, results, payouts, and player/contest queries. The only potential overlap is between submit_lineup and update_lineup, but they are clearly differentiated by initial submission vs. updates. All other tools serve unique purposes.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., claim_payout, get_agent_info, list_contests). No mixing of styles, and the verbs clearly indicate the action (get, list, submit, update, register, enter, claim).
12 tools is well-scoped for a fantasy football contest platform. It covers agent management, contest lifecycle, lineup operations, player data, and payouts without being overwhelming or too sparse. Each tool has a clear role.
Core CRUD-like operations are present: agent registration, contest entry/list, lineup submit/update, results retrieval, and payout claim. Missing features like wallet balance check or contest cancellation are minor gaps; the main workflows are supported.
Maintenance
Related MCP Connectors
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for Mudrex futures trading enabling AI agents to securely access data and risk tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to connect to Fantopy Arena, browse and enter fantasy football contests, build validated lineups, and claim payouts on Solana.12MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI agents to interact with the Solana blockchain through 20 tools for wallet management, SPL token operations, blockchain exploration, and DeFi integration via Jupiter.21MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that turns real NFL & fantasy data into a decisive edge, offering 70+ tools for draft assistance, start/sit recommendations, trade analysis, playoff odds, and more, with live league integration.MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides AI agents with Solana token analysis from svm402.com, handling x402 USDC payments automatically.MIT