Pug
Query events, funnels and retention in Pug analytics, and edit dashboards
- Pricing
- Open source
- Platforms
- API, self-hosted
- Runs
- Remotely
- Version
- 0.0.56
- Listing updated
- 3 days ago
About Pug
Pug is an open-source MCP server for analytics and data. It runs as a hosted remote server, so there is nothing to install locally.
Pug serves its analytics API as an MCP endpoint, so an agent can answer questions about product data without a hand-written query. Sixteen of its seventeen tools only read: running insights, browsing the raw event stream and looking up a single user. The seventeenth, upsert_dashboard, creates and edits dashboards.
The endpoint is a thin adapter: each call is replayed through the same handlers as an HTTP request, so validation and authorization behave identically. You sign in to Pug or use a private key, and connections act with the signed-in person's role.
It works with Claude's connector directory for Pug Cloud, or as a custom connector pointing at a self-hosted server. Pug itself is open source, built in Go on PostgreSQL, ClickHouse and NATS.
Install
Run in a terminal
claude mcp add --transport http pug https://api.pug.sh/mcpAdd to Settings → Connectors → Add custom connector
https://api.pug.sh/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"pug": {
"url": "https://api.pug.sh/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"pug": {
"type": "http",
"url": "https://api.pug.sh/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pug": {
"serverUrl": "https://api.pug.sh/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"pug": {
"type": "http",
"url": "https://api.pug.sh/mcp"
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- upsert_dashboard
- Creates and edits dashboards.
What it does
- Insight queries
- Run funnels, retention, trends and segmentation.
- Raw event browsing
- Look through the event stream.
- User lookup
- Inspect a single profile.
- Dashboard editing
- upsert_dashboard creates and edits dashboards.
- Same permissions as HTTP
- Calls go through the normal authorization path.
Good for
- Ask where users drop off in a funnel
- Compare retention across cohorts
- Look up what one user did
- Build a dashboard from a chat
Pricing
Open source
Open-source platform; Pug Cloud pricing not stated on the page
Prices change. Check docs.pug.sh before you buy.
Pug FAQ
How many tools are there?
Seventeen: sixteen read and one writes dashboards.
How do I sign in?
Through Pug sign-in, or with a private key for a custom connector.
Can I use a self-hosted Pug?
Yes, add your server's /mcp URL as a custom connector.
Is Pug free?
Yes. Pug is open source, so you can use and self-host it for free.
How do I add Pug to Claude Code?
Run this command in your terminal: claude mcp add --transport http pug https://api.pug.sh/mcp
What are the best alternatives to Pug?
The closest alternatives to Pug are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.
Alternatives to Pug

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media