English Français العربية

Engageable Analytics

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

Unified analytics MCP server for GA4, Mixpanel, and PostHog.

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package engageable
Claude Code 
claude mcp add engageable-analytics -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'POSTHOG_API_KEY=<your posthog_api_key>' -e 'POSTHOG_PROJECT_ID=<POSTHOG_PROJECT_ID>' -e 'GA4_CREDENTIALS_JSON=<your ga4_credentials_json>' -e 'GA4_PROPERTY_ID=<GA4_PROPERTY_ID>' -e 'MIXPANEL_SERVICE_ACCOUNT_USERNAME=<MIXPANEL_SERVICE_ACCOUNT_USERNAME>' -e 'MIXPANEL_SERVICE_ACCOUNT_SECRET=<your mixpanel_service_account_secret>' -e 'MIXPANEL_PROJECT_ID=<MIXPANEL_PROJECT_ID>' -- uvx engageable==0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "engageable-analytics": {
            "command": "uvx",
            "args": [
                "engageable==0.2.0"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<your anthropic_api_key>",
                "POSTHOG_API_KEY": "<your posthog_api_key>",
                "POSTHOG_PROJECT_ID": "<POSTHOG_PROJECT_ID>",
                "GA4_CREDENTIALS_JSON": "<your ga4_credentials_json>",
                "GA4_PROPERTY_ID": "<GA4_PROPERTY_ID>",
                "MIXPANEL_SERVICE_ACCOUNT_USERNAME": "<MIXPANEL_SERVICE_ACCOUNT_USERNAME>",
                "MIXPANEL_SERVICE_ACCOUNT_SECRET": "<your mixpanel_service_account_secret>",
                "MIXPANEL_PROJECT_ID": "<MIXPANEL_PROJECT_ID>"
            }
        }
    }
}

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

  • ANTHROPIC_API_KEY سري Anthropic API key (required for the 'ask' tool)
  • POSTHOG_API_KEY سري PostHog personal API key
  • POSTHOG_PROJECT_ID PostHog project ID
  • GA4_CREDENTIALS_JSON سري Google Analytics 4 service account credentials (inline JSON)
  • GA4_PROPERTY_ID Google Analytics 4 property ID
  • MIXPANEL_SERVICE_ACCOUNT_USERNAME Mixpanel service account username
  • MIXPANEL_SERVICE_ACCOUNT_SECRET سري Mixpanel service account secret
  • MIXPANEL_PROJECT_ID Mixpanel project ID

التوثيق

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

المحتويات
  1. Engageable
  2. Quickstart
  3. Claude Desktop
  4. Docker
  5. Tools
  6. Supported Data Sources
  7. How It Works
  8. Architecture
  9. License

Engageable

The open source analytics engine for AI agents.

One MCP server that connects to GA4, Mixpanel, PostHog, and more. 9 tools that replace per-platform integrations. Bring your own Anthropic key.

Quickstart

pip install engageable
export ANTHROPIC_API_KEY=sk-ant-...
export POSTHOG_API_KEY=phc_...
export POSTHOG_PROJECT_ID=12345
engageable-mcp

That's it. The MCP server is running on stdio. Connect it to Claude Desktop, Cursor, or any MCP client.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "engageable": {
      "command": "engageable-mcp",
      "args": []
    }
  }
}

Restart Claude Desktop. You'll see 9 analytics tools available.

Docker

ANTHROPIC_API_KEY=sk-ant-... docker compose -f docker-compose.mcp.yml up

Connects via SSE at http://localhost:8080/sse.

Tools

ToolWhat it does
get_sourcesList connected data sources
configure_sourceConnect a new data source (saves to ~/.engageable/credentials.json)
analyze_trendsTime-series analysis with trend detection, change points, anomalies
compare_segmentsA/B tests, before/after, segment breakdown with statistical significance
detect_anomaliesFind spikes, drops, and unusual patterns
analyze_retentionCohort retention curves (D1/D7/D30)
analyze_funnelMulti-step conversion funnel with drop-off rates
analyze_cohortDefine and compare user cohorts
askNatural language analytics questions (routes to other tools via LLM)

Supported Data Sources

SourceAuthWhat you need
PostHogAPI keyPOSTHOG_API_KEY + POSTHOG_PROJECT_ID
MixpanelService accountMIXPANEL_SERVICE_ACCOUNT_USERNAME + MIXPANEL_SERVICE_ACCOUNT_SECRET + MIXPANEL_PROJECT_ID
Google Analytics 4Service accountGA4_CREDENTIALS_JSON (path or inline) + GA4_PROPERTY_ID

Set these as environment variables, or use the configure_source tool to save them interactively to ~/.engageable/credentials.json. See credentials.example.json for the file format.

How It Works

Engageable exposes analytics tools via the Model Context Protocol (MCP). Any MCP-compatible client (Claude, Cursor, VS Code, custom agents) can discover and call these tools.

Each tool is a self-contained pipeline: parse the request, fetch data from the right connector, run analysis, return results. The ask tool adds an LLM routing layer for natural language questions.

Responses use CSV for tabular data (50% fewer tokens than JSON) with a 1000-cell budget to keep context windows manageable.

Architecture

MCP Client (Claude, Cursor, etc.)
    │
    ▼
┌─────────────────────────────────────┐
│  MCP Server (stdio or SSE)          │
│  - Dynamic tool registration        │
│  - Credential injection             │
│  - CSV response formatting          │
├─────────────────────────────────────┤
│  Composite Skills (agent-facing)    │
│  analyze_trends, compare_segments,  │
│  detect_anomalies, analyze_funnel,  │
│  analyze_retention, analyze_cohort, │
│  ask, get_sources, configure_source │
├─────────────────────────────────────┤
│  Connector Skills (internal)        │  Analysis Skills (internal)
│  ga4_query, posthog_query,          │  trend_detection, significance,
│  mixpanel_query, + metadata/probe   │  cohort_retention, forecasting,
│                                     │  bayesian_ab, correlation, ...
└─────────────────────────────────────┘

License

MIT

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

ما هو Engageable Analytics؟

Unified analytics MCP server for GA4, Mixpanel, and PostHog.

كيف أثبّت Engageable Analytics؟

يعمل على جهازك. في Claude Code: claude mcp add engageable-analytics -e 'ANTHROPIC_API_KEY=<your anthropic_api_key>' -e 'POSTHOG_API_KEY=<your posthog_api_key>' -e 'POSTHOG_PROJECT_ID=<POSTHOG_PROJECT_ID>' -e 'GA4_CREDENTIALS_JSON=<your ga4_credentials_json>' -e 'GA4_PROPERTY_ID=<GA4_PROPERTY_ID>' -e 'MIXPANEL_SERVICE_ACCOUNT_USERNAME=<MIXPANEL_SERVICE_ACCOUNT_USERNAME>' -e 'MIXPANEL_SERVICE_ACCOUNT_SECRET=<your mixpanel_service_account_secret>' -e 'MIXPANEL_PROJECT_ID=<MIXPANEL_PROJECT_ID>' -- uvx engageable==0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

نعم. يتطلب ANTHROPIC_API_KEY, POSTHOG_API_KEY, GA4_CREDENTIALS_JSON, MIXPANEL_SERVICE_ACCOUNT_SECRET، وتضبطها في إعداداته.

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

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Engageable Analytics؟

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

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