# kicktipp-agent

CLI, TUI dashboard, and MCP server for kicktipp.com and kicktipp.de. Version 1.2.0. Install from npm.

Kicktipp has no public API. This talks to the site from your machine with fetch and Cheerio. You get a CLI, a full-screen dashboard (`kicktipp tui`), and an MCP server that works with any MCP client: Claude, Codex, Cursor, Copilot, Windsurf, and others.

## Install

```
npm install -g kicktipp-agent
kicktipp login --web
```

Node.js 20 or newer. `login --web` opens http://127.0.0.1. Email and password go on that page. `kicktipp tui --demo` shows the whole interface with sample data, no account needed.

## Claude Desktop

Download [kicktipp.mcpb](https://github.com/christianheidorn/kicktipp-agent/releases/latest/download/kicktipp.mcpb) from the latest GitHub release. Double-click it, fill email and password, quit Desktop fully, start a new chat.

## Claude Code

```
claude mcp add kicktipp -- npx -y -p kicktipp-agent kicktipp-agent-mcp
```

Then say "Set up my Kicktipp account" and open the local link.

## Other MCP clients (Codex, Cursor, Copilot, …)

Standard MCP config: command `npx`, args `["-y", "-p", "kicktipp-agent", "kicktipp-agent-mcp"]`. No env block. Details: https://kicktipp-agent.com/agents/

## What it does

- 32 CLI commands including `tui` (full-screen dashboard), `today`, `bet` (TUI tip sheet), `sync`, `stats`, `rival`, `suggest`, `scenario`, `whatif`, `deadline`, `log` (with undo), `admin`
- 28 MCP tools including `connect_account`, `place_bets`, `get_stats`, `suggest_bets`, `get_bet_log`
- Works on kicktipp.com and kicktipp.de; optional German UI (`kicktipp set-lang de`)
- Read-only MCP mode, session-only credential storage, audit log with undo
- Config: `~/.config/kicktipp-agent/config.ini`

## Pages

- https://kicktipp-agent.com/tui/ — the dashboard and demo mode
- https://kicktipp-agent.com/analytics/ — stats, rival, suggest, scenario, whatif
- https://kicktipp-agent.com/agents/ — MCP setup for every client
- https://kicktipp-agent.com/security/ — the trust model
- https://kicktipp-agent.com/get-started/ — install guide
- https://kicktipp-agent.com/changelog/ — release history
- German versions under https://kicktipp-agent.com/de/

## Links

- https://github.com/christianheidorn/kicktipp-agent
- https://www.npmjs.com/package/kicktipp-agent
- https://kicktipp-agent.com/.well-known/mcp/server-card.json