# kicktipp-agent

CLI, TUI dashboard, and MCP server for [kicktipp.com](https://www.kicktipp.com) and [kicktipp.de](https://www.kicktipp.de). Version 1.2.0 on npm.

Kicktipp has no public API. This tool talks to the site from the user's machine. The password never leaves that machine. 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. `kicktipp tui --demo` shows the whole interface without an account.

## Agents

- Claude Desktop: [kicktipp.mcpb](https://github.com/christianheidorn/kicktipp-agent/releases/latest/download/kicktipp.mcpb)
- Claude Code: `claude mcp add kicktipp -- npx -y -p kicktipp-agent kicktipp-agent-mcp`
- Other MCP clients (Codex, Cursor, Copilot, …): command `npx`, args `["-y", "-p", "kicktipp-agent", "kicktipp-agent-mcp"]`

Then say "Set up my Kicktipp account" and open the localhost link. Do not paste the password into chat.

## Pages

- Home: https://kicktipp-agent.com/ (German: https://kicktipp-agent.com/de/)
- Dashboard (TUI): https://kicktipp-agent.com/tui/
- Analytics (stats, rival, suggest, scenario, whatif): https://kicktipp-agent.com/analytics/
- AI agents & MCP setup: https://kicktipp-agent.com/agents/
- Security model: https://kicktipp-agent.com/security/
- Install guide: https://kicktipp-agent.com/get-started/
- Changelog: https://kicktipp-agent.com/changelog/

## Links

- Agent setup prompt: https://kicktipp-agent.com/prompt.txt
- GitHub: https://github.com/christianheidorn/kicktipp-agent
- npm: https://www.npmjs.com/package/kicktipp-agent
- MCP card: https://kicktipp-agent.com/.well-known/mcp/server-card.json
- Skill: https://kicktipp-agent.com/.well-known/agent-skills/kicktipp-agent/SKILL.md
- Auth: https://kicktipp-agent.com/auth.md