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., "@kickbase-mcp Check my squad and budget, find undervalued players on the market and propose trades."
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.
MCP server for Kickbase (Bundesliga fantasy football) built on the unofficial, community-documented API v4.
It exposes your squad, budget, lineup, the transfer market, player stats, fixtures and real trading operations — so an AI assistant can build buy/sell strategies and (if you let it) execute them.
uv syncRelated MCP server: FPL MCP Server
The server needs KICKBASE_EMAIL and KICKBASE_PASSWORD, resolved in this
order:
Environment variables
.env file (see .env.example)
pass-cli)Put secret references in .env:
KICKBASE_EMAIL="pass://MyVault/Kickbase/username"
KICKBASE_PASSWORD="pass://MyVault/Kickbase/password"then launch the server through pass-cli run, which injects the resolved
values as environment variables:
pass-cli run --env-file .env -- uv run kickbase-mcpuv run kickbase-mcp # stdio transport (default)With plain .env credentials:
{
"mcpServers": {
"kickbase": {
"command": "uv",
"args": ["--directory", "/path/to/kickbase-mcp", "run", "kickbase-mcp"]
}
}
}With Proton Pass injection:
{
"mcpServers": {
"kickbase": {
"command": "pass-cli",
"args": [
"run", "--env-file", "/path/to/kickbase-mcp/.env", "--",
"uv", "--directory", "/path/to/kickbase-mcp", "run", "kickbase-mcp"
]
}
}
}Read:
list_leagues, get_my_status, get_league_overview, get_league_ranking,
get_activity_feed, get_my_squad, get_my_lineup, get_market,
get_market_player, search_players, get_scouted_players,
get_player_profile, get_player_performance,
get_player_market_value_history, get_player_transfer_history,
get_manager_squad, get_manager_transfers, get_user_teamcenter,
get_fixtures, get_competition_table
Trades (real side effects on your team):
place_offer, withdraw_offer, accept_offer, decline_offer,
list_player_for_sale, remove_player_from_market,
sell_player_to_kickbase, set_lineup, scout_player, unscout_player,
collect_daily_bonus
Strategy:
analyze_transfer_market — one call that combines your budget, squad flags
(injuries, falling value, low averages), every market listing scored by
points-per-million, expiry urgency and next-fixture opponent strength.
Check my budget and squad, find weak players I should sell and undervalued players on the market with good upcoming fixtures, then propose concrete trades — but ask before executing anything.
Accept a manager's offer on one of your listed players. REAL SALE.
Inputs: offer_id (required), player_id (required), league_id.
Composite analysis for buy/sell strategy.
Returns your budget, squad valuation flags, and every market listing scored by points-per-million, market-value trend, expiry urgency and upcoming opponent strength (next N matchdays). Use this to decide which players to sell and which market bargains to buy.
Inputs: league_id, horizon_matchdays. Returns: object
Collect the daily login bonus if available.
Inputs: no named parameters.
Decline a manager's offer on one of your listed players.
Inputs: offer_id (required), player_id (required), league_id.
League activity feed (transfers, market events, comments).
Inputs: start, league_id, max_items.
Real Bundesliga table: team strength for fixture difficulty analysis.
Inputs: league_id. Returns: result
Bundesliga fixtures grouped by matchday (all or a specific day).
Inputs: day, league_id. Returns: object
League overview: name, competition, members and settings.
Inputs: league_id. Returns: object
League table of managers (season points, matchday points, team values).
Inputs: day, league_id. Returns: object
Another manager's squad. Get user ids from get_league_ranking.
Inputs: user_id (required), league_id. Returns: result
A manager's recent buy/sell transactions.
Inputs: user_id (required), start, league_id.
Players currently on the transfer market with price, expiry and offers.
sellerUserId is null for players listed by Kickbase itself (buy instantly at the listed price via place_offer) and set for manager listings.
Inputs: league_id. Returns: object
Details of one market player including all offers made so far.
Inputs: player_id (required), league_id. Returns: object
Your current starting eleven and bench players.
Inputs: league_id. Returns: result
Your full squad with market value, trend, points, status and position.
Inputs: league_id. Returns: result
Get your status in a league: budget, team value, points and placement.
Inputs: league_id. Returns: object
Market value history for a player. timeframe = days back to look.
Inputs: player_id (required), league_id, timeframe.
Matchday-by-matchday points history for a player.
Inputs: player_id (required), league_id.
Full player profile: stats, market value, status and club info.
Inputs: player_id (required), league_id. Returns: object
Transfer history: who bought/sold this player and at which price.
Inputs: player_id (required), start, league_id.
Your watchlist / scouted players.
Inputs: league_id.
Team center of a user (points per player for a matchday).
Inputs: user_id (required), day, league_id.
List all Kickbase leagues the account is in (id, name, budget, users).
Inputs: no named parameters. Returns: result
Put one of your squad players on the transfer market at an asking price.
Inputs: price (required), player_id (required), league_id.
Place an offer on a market player. REAL TRANSACTION.
For Kickbase-listed players (sellerUserId null), offering the listed price buys the player instantly if your budget covers it. For manager listings the offer goes to the manager for accept/decline.
Inputs: price (required), player_id (required), league_id.
Take your listed player off the transfer market (cancel the listing).
Inputs: player_id (required), league_id.
Add a player to your watchlist.
Inputs: player_id (required), league_id.
Search for any Bundesliga player by name (not only market listings).
Inputs: query (required), league_id, max_items.
Accept Kickbase's system offer on a listed player: instant sale. REAL SALE.
Inputs: player_id (required), league_id.
Set the starting eleven. REAL CHANGE to your team.
player_ids: exactly 11 player ids in lineup order. formation: kickbase formation type code (use the current value from get_my_lineup context or the app; '1' is a common default).
Inputs: player_ids (required), formation, league_id.
Remove a player from your watchlist.
Inputs: player_id (required), league_id.
Withdraw your own pending offer on a market player.
Inputs: offer_id (required), player_id (required), league_id.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 32 tools
Most tools have clearly distinct purposes: market vs. squad vs. watchlist vs. manager data vs. real transactions are well separated by prefixes and descriptions. Minor overlap exists among the read-only player data tools (get_player_profile, get_player_performance, get_player_market_value_history, get_player_transfer_history), but descriptions distinguish their data scopes adequately.
All names use snake_case verb_noun patterns with a small, predictable verb set (get_, list_, set_, place_, accept_, decline_, withdraw_, remove_, scout_). Minor deviations like the 'my' qualifier vs. resource qualifiers and the long sell_player_to_kickbase are readable and don't break the pattern.
32 tools is heavy for this domain; while each roughly earns its place, several read-only player-data tools could be merged or parameterized. The volume forces an agent to scan many similar get_ tools to find the right one.
Coverage spans the full lifecycle: league/status oversight, squad and lineup management, market browsing, offer placement/withdrawal/acceptance, listings, watchlist, player analytics, fixtures, and a composite analysis tool. No obvious CRUD or workflow gaps remain for the Kickbase fantasy-manager domain.
Your Fantasy Premier League team in your AI: analyses, injuries, prices, fixtures and player cards.
NFL analytics tools for AI agents: stats, fantasy, injuries, schedules, and advanced analysis.
Fantasy football for any AI agent: draft board, start/sit, waivers, your Sleeper league. Free.
Fantasy Premier League (FPL) assistant: one clear call on captain, transfers and chips.
