kicktipp-agent
CLI and MCP server for kicktipp.com — view leaderboards, schedules, league tables, and place bets from the terminal or through AI assistants like Claude.
Install / Use
claude mcp add christianheidorn -- npx -y github:christianheidorn/kicktipp-agentIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OtherSupported Platforms
Tags
Our assessment of kicktipp-agent
kicktipp-agent scores 84/100 on our quality scale, 217th of 329 Other skills we index.
Its MCP Server is 24 KB long, well organised into 39 sections with 27 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so kicktipp-agent is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
kicktipp-agent compared with similar skills
All 4 of these similar skills score higher than kicktipp-agent; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| kicktipp-agent (this skill)by christianheidorn | 84 | 10 | 3mo ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install kicktipp-agent?
- Run
claude mcp add christianheidorn -- npx -y github:christianheidorn/kicktipp-agent. The install tabs above show the steps for each supported agent. - Which AI agents does kicktipp-agent work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is kicktipp-agent safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is kicktipp-agent still maintained?
- The repository was last updated about 3 months ago, so kicktipp-agent is actively maintained.
Skill content
View source on GitHubkicktipp-agent
A helper for Kicktipp on kicktipp.com and kicktipp.de. You can check the table, place tips in a TUI (terminal UI), or ask Claude to do it in a chat.
Kicktipp has no public API, so this talks to the website from your own computer. Your password never leaves the machine. Do not type it into a chat.
Start here
You only need one of the four sections below. Read the headings, pick the one that matches how you work, ignore the others.
| If you… | Go to |
|---------|--------|
| Chat with Claude as a desktop app | Claude Desktop |
| Use Claude in the terminal (Claude Code), or another MCP client | Claude Code |
| Want kicktipp commands in the terminal yourself | The kicktipp command |
| Are editing this project's source | Working on the code |
Every path needs Node.js 20 or newer. Open the site, click the big LTS button, run the installer, and leave the defaults. When it is done, open Terminal (macOS) or Command Prompt (Windows) and type:
node -v
You want a reply like v20.19.0 or v22.something. If the computer says the command was not found, Node is not installed, or you need to close the terminal and open a new one so it picks up the installer.
Two ways to get the program itself:
- npm downloads the published package named
kicktipp-agent. You do not keep a copy of this GitHub repo. This is the usual choice if you just want it to work. - This repo means
git cloneof the source, thennpm installandnpm run buildon your machine. Use this if you want the code in a folder you can open, or you are working from git rather than the registry.
Claude Desktop
This is the least terminal-heavy path. After Node is installed, you can stay in the Claude app.
Install the Desktop file
This is a zip Claude Desktop knows how to install. It is the same Node program, with a settings form.
- Download kicktipp.mcpb from the latest GitHub release. The file version should match the release tag, for example both
1.1.1. - Double-click the file. Claude Desktop should offer to install it. If nothing happens, open Claude Desktop and install the file from there.
- Fill in the email and password you use on kicktipp.com or kicktipp.de. You can leave community blank and pick the pool later. Tick read-only if you only want Claude to look, not submit tips.
- Fully quit Claude Desktop. Closing the window is not enough on a Mac. Use Claude → Quit, then open it again.
- Start a new chat. Ask something like "What's my Kicktipp status?"
If Claude says it cannot find node, Node is missing from your PATH. Install LTS from nodejs.org, quit Desktop fully, try again.
Or use a clone of this repo
Same program, no .mcpb file. You clone the repo, build it, then tell Desktop to run dist/server.js. That needs a JSON edit. Step-by-step is under Connecting Claude. Do not add the bundle and that JSON at the same time, or you will start two copies.
Claude Code
Claude does not log into Kicktipp itself. It starts a small program on your computer. You attach that program once, then in a chat you tell it to set up your account. It will give you a link to http://127.0.0.1:… on your own machine. Open that in a normal browser, sign in, pick your pool. The password goes into that page, never into the chat.
From npm
This command downloads the kicktipp-agent package when needed and starts the MCP server. You do not have to clone anything.
claude mcp add kicktipp -- npx -y -p kicktipp-agent kicktipp-agent-mcp
The long name kicktipp-agent-mcp is the server binary. kicktipp-mcp is the same binary under a shorter name.
From this repo
You keep a folder with the source, compile it, then point Claude at that file. Run these from a terminal. The last line uses pwd so you do not have to type the folder path by hand. Run it while you are still inside kicktipp-agent.
git clone https://github.com/christianheidorn/kicktipp-agent.git
cd kicktipp-agent
npm install
npm run build
claude mcp add kicktipp -- node "$(pwd)/dist/server.js"
npm install fetches libraries. npm run build compiles TypeScript into dist/. On Windows, $(pwd) may not work. Use the full path to dist\server.js instead.
After either option
Open a new chat and say Set up my Kicktipp account. Open the local link, sign in, pick the community. After that, you can ask for status, the table, or to help with tips.
Editing Claude Desktop's config by hand is this same server. Details are in Connecting Claude.
The kicktipp command
This is for using Kicktipp from the terminal without an assistant. After it is installed you run kicktipp login --web once, then commands like kicktipp today and kicktipp bet.
From npm
This puts kicktipp on your PATH so it works in any terminal window:
npm install -g kicktipp-agent
kicktipp login --web
If you would rather not install globally, this runs the same login without -g:
npx -y -p kicktipp-agent kicktipp login --web
-p kicktipp-agent tells npx which package to download. The last kicktipp is the command inside that package.
From this repo
Clone, install libraries, compile, then npm link so the kicktipp command uses this folder's build:
git clone https://github.com/christianheidorn/kicktipp-agent.git
cd kicktipp-agent
npm install
npm run build
npm link
kicktipp login --web
After either option
login --web prints a http://127.0.0.1:…/setup?token=… link. On macOS and Linux it should open in your browser by itself. On Windows, copy that line into a browser if a window does not appear.
Sign in with your Kicktipp email and password, then pick your pool. After that:
kicktipp today
kicktipp bet
today lists today's matches. bet opens the TUI, a full-screen tip sheet, if you are in a real terminal.
Working on the code
From a clone:
npm install
npm run build
npm test
npm run pack:mcpb builds the Desktop .mcpb file yourself. If you only want to use Desktop, download the file from releases instead.
CLI
The CLI and the localhost setup page default to English, and they start on kicktipp.com. To keep German chrome and the German site:
kicktipp set-lang de
kicktipp set-site de
That writes [ui] in ~/.config/kicktipp-agent/config.ini. --lang de and --site de are one-shot overrides for a single run. Team names still come from whichever Kicktipp host you use.
First-time setup
kicktipp login --web
That prints a http://127.0.0.1:…/setup?token=… link and opens it on macOS and Linux. On Windows, paste the link into a browser. Email and password go into that page, not into the terminal. After a successful Kicktipp login you pick a community. Credentials land in ~/.config/kicktipp-agent/config.ini with mode 600.
kicktipp login without --web still prompts in the terminal, same as set-community on a first run.
Optionally set your player name so the leaderboard highlights your position:
$ kicktipp set-player
Commands
| Command | Description |
|---------|-------------|
| tui | Full-screen dashboard for every feature (--demo to explore with sample data) |
| login | Connect an account (--web opens a localhost page) |
| logout | Remove stored credentials and session |
| communities | List all communities you belong to |
| set-community | Select a default community |
| set-lang | Set the UI language permanently (en or de) |
| set-site | Set the Kicktipp host permanently (de or com) |
| players | List players in the saved community |
| set-player | Select which player you are |
| set-notify | Configure the notify backend (desktop, webhook, or command) |
| leaderboard | Show the matchday leaderboard |
| overview | Show the season overview |
| schedule | Show the match schedule |
| table | Show the league table |
| bets | Show your bets for a matchday |
| bet | Place bets. Opens the TUI on a real terminal, or by fixture / bonus |
| today | Show today's matches and which still need bets |
| rules | Show the game rules |
| guide | Print a detailed usage guide (useful for LLM agents) |
| sync | Download this season into the local cache |
| cache status / cache clear | Inspect or delete the cache |
| stats | Season analytics for you or another player |
| rival | What it would take to overtake another player |
| suggest | Bet slip suggested from the published odds |
| scenario | Project the leaderboard under hypothetical results |
| whatif | Replay the season under a different strategy |
| deadline | Time to kickoff and what still needs a bet |
| remind / notify | Reminder artifacts and notifications |
| log | What this agent submitted, and undo |
| profiles | List configured profiles |
| admin | Spielleiter tools (members, bets for a member) |
The dashboard (kicktipp tui)
kicktipp tui opens a full-screen dashboard that covers everything the CLI does from one keyboard-driven interface: today's matches, your bets, the interactive place-bets grid, odds-based suggestions, the leaderboard, season overview, league table, schedule, deadlines, stats, rival watch, scenarios, what-if replays, sync/cache, rules, the audit log, community and player selection, notification settings, and the Spielleiter admin tools.
Move through the grouped menu on the left with the arrow keys, press enter to open a screen, and esc to come back. [ and ] step through matchdays, ? shows the shortcuts, and each screen lists its own keys along the bottom.
kicktipp tui # live, against your account
kicktipp tui --demo # explore the whole interface with sample data, no login
The --demo flag fills the dashboard with a generated Bundesliga season so you can try every screen — including the analytics — without connecting an account.
The prediction grid (kicktipp bet)
On a real terminal, kicktipp bet with no arguments opens the prediction grid: a full-screen list of the matchday. Type scores in place, take the odds-based suggestion, submit with w. The same grid is reachable as "Place bets" inside kicktipp tui.

Keys:
- arrows move
- digits type a score
stake the suggestion on the current rowafill every empty row from suggestionsuclear the current rowwsubmitqquit without submitting
kicktipp bet --no-tui is the old one-match-at-a-time prompts. Bonus questions still use that path (kicktipp bet --bonus). You can also pass fixtures on the command line:
kicktipp bet "FC Bayern München vs Borussia Dortmund=2:1"
kicktipp bet "RB Leipzig vs Bayer 04 Leverkusen=0:0" --matchday 5
kicktipp bet --bonus "Who will win the league?=FC Bayern München"
Options
--matchday <n>— Target a specific matchday (1-34)--bonus— Bonus question rankings (withleaderboard) or bonus bets (withbet)--view <value>— Overview type (withoverview)--home/--away— Home/away filter (withtable)
Analytics
Once a season is cached locally, the agent can answer questions Kicktipp itself does not:
kicktipp sync # update the local cache (current matchday and holes)
kicktipp stats # your form, hit types, biases, consistency
kicktipp stats --player Papa # or somebody else's
kicktipp riv
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
