Open Source · Football CLI & MCP

Kicktipp. From Your Terminal.

View leaderboards, check schedules, place bets — all from the command line or through AI assistants like Claude.

Get Started View on GitHub
15 CLI Commands
15 MCP Tools
TS TypeScript
kicktipp — zsh
Why

No browser. No problem.

Kicktipp lacks a public API. This project fills the gap with two powerful interfaces.

10x

Lightning Fast CLI

Check scores, standings, and place bets in seconds. No clicking through pages, no waiting for ads to load.

$ kicktipp leaderboard
0 clicks

AI‑Powered MCP

Connect Claude or any MCP client to your Kicktipp account. Let your AI assistant manage bets for you.

"Place my bets for matchday 18"
100%

Secure & Local

Credentials stored locally with chmod 600. No cloud, no third-party servers. Your data stays on your machine.

~/.config/kicktipp-agent/config.ini
1 cmd

Batch Betting

Place all your matchday bets in a single command. No need to click through every match one by one.

$ kicktipp bet "Bayern vs BVB=2:1"
Live

Scores & Standings

Pull today's matches, the full schedule, and your points tally without ever opening a browser tab.

$ kicktipp today
OSS

TypeScript & Open Source

Fully typed codebase, MIT licensed. Easy to read, extend, and contribute to. Built for developers.

$ npm link

Browser

VS

kicktipp-agent

Browser
Open browser, navigate to kicktipp.com
Log in, find your group, find the matchday
Click each match, type each score, submit
Repeat every matchday — 30+ minutes/week
CLI / MCP
One command or one prompt
Session caching — no repeated logins
All bets placed in one batch
Or let AI handle it — 0 minutes/week
AI Agent

Let AI play your game

Connect an MCP-compatible assistant and let it handle your Kicktipp automatically.

01

Wake up to wins

It's matchday morning. While you're still in bed, Claude has already checked the latest form, analyzed the standings, and placed your bets. You just wake up and check the leaderboard.

02

3 seconds, not 30 minutes

Your rivals spend half an hour every matchday researching form and placing bets. Your AI agent does it in seconds — with better data and zero bias.

03

Never miss a deadline

Forgot to place your bets before kickoff? Again? With an MCP-connected assistant, that never happens. It monitors your matchday and acts before you even think about it.

claude — mcp session
Commands

Your matchday toolkit

15 CLI commands and 15 MCP tools to dominate your league.

todayToday's matches and which still need bets
betPlace bets interactively, by fixture, or bonus
leaderboardShow the matchday leaderboard
overviewShow the season overview
scheduleShow the match schedule
tableShow the league table
betsShow your bets for a matchday
communitiesList all communities you belong to
playersList players in the saved community
set-communitySelect a default community
set-playerSelect which player you are
rulesShow the game rules
guidePrint a detailed usage guide
logoutRemove stored credentials and session
get_today_matchesToday's matches with bet status
place_betsPlace match bets by fixture name
get_leaderboardPlayer rankings for a matchday
get_overviewSeason overview across all matchdays
get_scheduleMatch schedule with results
get_tableLeague table (football standings)
get_betsMatches and current bets for a matchday
get_communitiesList communities the user belongs to
get_playersList players in the community
set_communitySet the active community
set_playerSet which player you are
get_rulesGame rules and scoring system
get_statusCheck credentials and configuration
get_bonus_questionsBonus questions with answer options
place_bonus_betsPlace bonus question answers
Integration

Works with Claude

Add to your Claude Desktop or Claude Code config and start managing your Kicktipp through AI.

How it works

The MCP server exposes all functionality through the Model Context Protocol. Your AI assistant calls get_status first to check configuration, then uses any of the 15 available tools on your behalf.

Credentials are passed via environment variables — your AI assistant never sees them.

Claude Desktop Claude Code Any MCP Client
claude_desktop_config.json 
{
  "mcpServers": {
    "kicktipp": {
      "command": "kicktipp-mcp",
      "env": {
        "KICKTIPP_EMAIL": "you@example.com",
        "KICKTIPP_PASSWORD": "yourpassword"
      }
    }
  }
}
Quick Start

Kick off in seconds

Four commands. You're in the game.

1
Install dependencies
$ npm install
2
Install the browser engine
$ npx playwright install chromium
3
Compile TypeScript
$ npm run build
4
Link globally
$ npm link

Ready to kick off?

Star the repo, clone it, and never open kicktipp.com in a browser again.

Star on GitHub View Installation
About the Creator
Christian Heidorn

Christian Heidorn

Solopreneur · AI Creator · 60K+ YouTube Subscribers

I run Tokenized, where I explore the creative edges of AI, Tokenization, and the Creator Economy.

I built kicktipp-agent because I was tired of clicking through the Kicktipp website every matchday. As someone who lives in the terminal, I wanted a faster way to manage my bets — and once MCP came along, letting Claude handle it entirely was the obvious next step.