Skip to content
MCP server

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/mcp

Add to Settings → Connectors → Add custom connector

https://api.pug.sh/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pug": {
      "url": "https://api.pug.sh/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media