English Français العربية

Plausible Analytics MCP

Registre officiel Marketing et ventes

Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package plausible-mcp
Claude Code 
claude mcp add plausible-analytics-mcp -e 'PLAUSIBLE_API_KEY=<PLAUSIBLE_API_KEY>' -e 'PLAUSIBLE_SITE_ID=<PLAUSIBLE_SITE_ID>' -e 'PLAUSIBLE_BASE_URL=<PLAUSIBLE_BASE_URL>' -- uvx plausible-mcp==0.1.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "plausible-analytics-mcp": {
            "command": "uvx",
            "args": [
                "plausible-mcp==0.1.3"
            ],
            "env": {
                "PLAUSIBLE_API_KEY": "<PLAUSIBLE_API_KEY>",
                "PLAUSIBLE_SITE_ID": "<PLAUSIBLE_SITE_ID>",
                "PLAUSIBLE_BASE_URL": "<PLAUSIBLE_BASE_URL>"
            }
        }
    }
}

Variables d'environnement

  • PLAUSIBLE_API_KEY Plausible Analytics API token
  • PLAUSIBLE_SITE_ID Default Plausible site domain / ID (e.g. yourdomain.com)
  • PLAUSIBLE_BASE_URL Custom self-hosted Plausible instance URL (default: https://plausible.io)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. plausible-mcp
  2. Quick Start
  3. Environment Configuration
  4. Available Tools
  5. Error Absorption Standard
  6. MCP Client Setup
  7. License

plausible-mcp

Fast, privacy-first Plausible Analytics Model Context Protocol (MCP) server for AI coding agents and LLM harnesses. Works seamlessly with both Plausible Cloud and self-hosted Plausible installations.

Quick Start

Run with uvx (Python)
export PLAUSIBLE_API_KEY="your_api_key_here"
uvx plausible-mcp
Run with npx (Node / npm bridge)
export PLAUSIBLE_API_KEY="your_api_key_here"
npx -y plausible-analytics-mcp

Environment Configuration

VariableDescriptionDefault
PLAUSIBLE_API_KEYYour Plausible Stats/Sites API tokenRequired (or pass via tool token arg)
PLAUSIBLE_BASE_URLBase URL for self-hosted Plausiblehttps://plausible.io
DO_NOT_TRACKSet to 1 to disable anonymous telemetry0
Getting an API Key
  1. Log in to Plausible (Cloud or your self-hosted instance).
  2. Go to Settings (user profile menu) -> API Keys.
  3. Click + New Key, name it mcp-agent, and copy the token.
  4. Export as PLAUSIBLE_API_KEY="your_token".

Available Tools

ToolDescription
get_aggregate_stats(site_id, date_range="30d", metrics=None, token=None)High-level visitor, pageview, bounce rate, and session duration totals
get_breakdown(site_id, property_name="event:page", date_range="30d", limit=20, token=None)Segment metrics by pages, traffic sources, countries, browsers, OS, devices
get_realtime_visitors(site_id, token=None)Current count of active visitors on the site right now
get_timeseries(site_id, date_range="30d", interval="date", token=None)Daily or monthly trendline data points for chart generation
doctor(token=None)Test Plausible API connectivity and validate the configured API token
skills_list()List dynamic analytics playbooks and methodology guides
skill_read(name)Fetch full markdown playbook by name (e.g. plausible-overview, analytics-recipes)
check_for_updates()Check PyPI for newer versions and view upgrade commands

Error Absorption Standard

Errors returned to agents are explicitly classified:

  • [INPUT_FIXABLE]: Parameter errors (e.g., misspelled site_id, unknown dimension). Fix arguments and retry.
  • [ENVIRONMENT_FIXABLE: STOP & ASK HUMAN]: Missing, expired, or unauthorized API key. Prompt user with guided setup steps.
  • [TRANSIENT]: Upstream rate limits (HTTP 429) or network hiccups. Wait briefly and retry.

MCP Client Setup

Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "plausible": {
      "command": "uvx",
      "args": ["plausible-mcp"],
      "env": {
        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"
      }
    }
  }
}

Or using the npm bridge:

{
  "mcpServers": {
    "plausible": {
      "command": "npx",
      "args": ["-y", "plausible-analytics-mcp"],
      "env": {
        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"
      }
    }
  }
}

License

MIT License. See LICENSE for details.

Questions fréquentes

Qu'est-ce que Plausible Analytics MCP ?

Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.

Comment installer Plausible Analytics MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add plausible-analytics-mcp -e 'PLAUSIBLE_API_KEY=<PLAUSIBLE_API_KEY>' -e 'PLAUSIBLE_SITE_ID=<PLAUSIBLE_SITE_ID>' -e 'PLAUSIBLE_BASE_URL=<PLAUSIBLE_BASE_URL>' -- uvx plausible-mcp==0.1.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Plausible Analytics MCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Plausible Analytics MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Plausible Analytics MCP ?

Il est publié par surendranb. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.