English Français العربية

Plausible Analytics MCP

السجل الرسمي التسويق والمبيعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • 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)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو Plausible Analytics MCP؟

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

كيف أثبّت Plausible Analytics 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Plausible Analytics MCP إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Plausible Analytics MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Plausible Analytics MCP؟

ينشره surendranb. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.