Home

takt-mcp wiki

@vskstudio/takt-mcp is a Model Context Protocol server that exposes a self-hosted Takt instance's privacy-friendly analytics to any MCP-aware AI agent (Claude Desktop, Claude Code, Cursor, …).

It is a thin, read-only stdio client. It runs on your machine and talks to your Takt instance with your single-site API key. Nothing is hosted by us.

AI agent  ──stdio (MCP)──▶  takt-mcp  ──HTTPS + Bearer──▶  Takt /api/v1

Pages

• Getting Started — install and connect it to your agent
• Tools — every tool and its parameters
• Configuration — environment variables and tuning
• Architecture — modules and design rationale
• Recipes — example prompts
• Troubleshooting — common errors and fixes
• FAQ

At a glance

Transport	stdio (MCP)
Auth	Takt API key (Bearer), single-site scoped
Mode	read-only (GET only)
Tools	10 (stats + sites)
Resources	takt://sites (when TAKT_ORG is set)
Node	≥ 18

The canonical docs live in the repo (README.md, docs/). This wiki mirrors them for quick browsing.