io.github.edholofy/eyepup
Official5 toolsAgentic visitor analytics — five tools that hand the next CRO fix to your coding agent.
Analyze visitor behavior and provide conversion optimization recommendations to agents.
Captured live from the server via tools/list.
eyepup_ask
Ask a natural-language question about your site visitors. Use this when the user asks 'why are people bouncing from /pricing', 'who's hot right now', 'what changed this week', or any other free-text question about visitor behaviour. Returns an LLM-grounded answer with evidence and ranked actions.
Parameters (3)
- questionstringrequired
The free-text question.
- sitestring
Optional apex domain to scope.
- daysinteger
Lookback days (default 7).
eyepup_todo
Get the top friction patterns ranked by impact score. Use BEFORE making any UX edit — the highest-impact pattern is usually a more valuable fix than whatever the user just asked about. Each row carries a paste-ready recommended_action.
Parameters (2)
- sitestring
Apex-domain scope.
- limitinteger
Max patterns (default 5).
eyepup_visitors_hot
Return the top high-intent visitors currently active. Use when the user asks 'who's hot', 'who's about to convert', 'who should I focus on'.
Parameters (2)
- sitestring
- limitinteger
eyepup_visitor
Fetch the full LLM-written profile for a single visitor by distinct_id. Use after eyepup_visitors_hot or eyepup_todo to dig into a specific visitor.
Parameters (1)
- distinct_idstringrequired
UUID-shaped distinct_id.
eyepup_log
Log a change you just shipped. The dossier agent reasons about every visitor profiled AFTER this log row, so it can grade whether the friction pattern recovered. CALL THIS after every UX edit.
Parameters (5)
- titlestringrequired
One-line headline of what shipped.
- kindstring
- pathsstring
Comma-separated paths affected.
- descriptionstring
- sitestring
README not available yet.
Install
Configuration
EYEPUP_API_TOKENrequiredsecretEyepup API token (epk_live_*). Mint at https://eyepup.com/integrations.
claude_desktop_config.json
{
"mcpServers": {
"eyepup": {
"command": "npx",
"args": [
"-y",
"eyepup-mcp@0.1.1"
],
"env": {
"EYEPUP_API_TOKEN": "<YOUR_EYEPUP_API_TOKEN>"
}
}
}
}