eyepup-mcp

MCP server for Eyepup — agentic visitor analytics your coding agent can call as native tools.

What it gives you

Five tools for any MCP client (Claude Code, Cursor, Codex, OpenClaw, NemoClaw, Hermes):

• eyepup_ask — natural-language Q&A about your visitors
• eyepup_todo — top friction patterns ranked by impact
• eyepup_visitors_hot — highest-intent visitors right now
• eyepup_visitor — full dossier for one distinct_id
• eyepup_log — write-back changelog so the dossier agent reasons about your deploys

Install

Claude Code — remote (recommended)

One URL, no shell, no env var management:

claude mcp add eyepup --transport http https://eyepup.com/mcp
# Paste your epk_live_... token when prompted

Claude Code — stdio (CI / air-gapped)

claude mcp add eyepup --transport stdio \
  --env EYEPUP_API_TOKEN=epk_live_... \
  -- npx -y eyepup-mcp

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "eyepup": {
      "command": "npx",
      "args": ["-y", "eyepup-mcp"],
      "env": {
        "EYEPUP_API_TOKEN": "epk_live_..."
      }
    }
  }
}

Codex / any other MCP client

Same shape. The package is eyepup-mcp, the binary is eyepup-mcp, the only env var is EYEPUP_API_TOKEN.

Get a token

Mint at eyepup.com/integrations → Programmatic access. The same epk_live_* token the eyepup CLI uses — one credential shared across surfaces.

Local dev

git clone https://github.com/edholofy/agentic-analytics
cd mcp
npm install
npm run dev   # tsc --watch

Test against a local agent by setting EYEPUP_API_BASE:

EYEPUP_API_BASE=http://localhost:3000 \
EYEPUP_API_TOKEN=epk_live_... \
node dist/index.js

Roadmap

• [x] Day-1: stdio with 5 tools
• [x] Week-1: remote Streamable-HTTP at https://eyepup.com/mcp
• [ ] OAuth 2.1 + DCR (replaces Bearer token paste)
• [ ] Claude Code plugin + companion subagent
• [ ] MCP Registry submission

License

MIT