Umami MCP

npx add-mcp 'https://cloud.umami.is/mcp'

@umami/mcp

Model Context Protocol सर्वर Umami एनालिटिक्स के लिए। Claude, ChatGPT, Cursor और अन्य MCP क्लाइंट्स को आपकी वेबसाइट ट्रैफ़िक के बारे में सवालों के जवाब देने देता है, जो केवल-पठनीय टूल्स का उपयोग करते हैं जो @umami/api-client के माध्यम से Umami API को कॉल करते हैं।

MCP सर्वर कभी भी डेटाबेस से बात नहीं करता; हर टूल सार्वजनिक API और वेब ऐप के समान उपयोगकर्ता/टीम अनुमति जाँचों से होकर गुजरता है।

टूल्स

टूल	उद्देश्य
list_websites	उन वेबसाइटों को खोजें जिन तक आप पहुँच सकते हैं (पहले कॉल करें ताकि websiteId मिल सके)।
get_website_daterange	रिकॉर्ड किए गए डेटा के साथ सबसे पुरानी और नवीनतम तिथियाँ।
get_website_stats	पेजव्यू, विज़िटर, विज़िट, बाउंस दर, अवधि + पिछली अवधि।
get_website_traffic	पेजव्यू/विज़िट समय श्रृंखला मिनट, घंटे, दिन, महीने या वर्ष के अनुसार।
get_website_metrics	शीर्ष पेज, रेफरर, चैनल, देश, ब्राउज़र, डिवाइस, UTM, इवेंट।
get_realtime	अभी सक्रिय विज़िटर।
get_events	व्यक्तिगत ट्रैक किए गए इवेंट (पेजिनेटेड)।
get_event_stats	कस्टम इवेंट कुल + पिछली अवधि।
get_event_series	समय के साथ कस्टम इवेंट गणना, इवेंट नाम से समूहीकृत।
get_event_properties	कस्टम इवेंट गुण नाम, या एक गुण के मान।
get_sessions	विज़िटर सत्र (पेजिनेटेड)।
get_session_stats	सत्र-स्तरीय कुल: विज़िटर, विज़िट, पेजव्यू, इवेंट, देश।
get_annotations	टाइमलाइन पर दिनांकित नोट्स (लॉन्च, अभियान) परिवर्तन समझाने के लिए।
list_segments	सहेजे गए सेगमेंट और कोहोर्ट; filters.segment / .cohort के माध्यम से आईडी पास करें।
get_session	एक सत्र उसकी गतिविधि टाइमलाइन और गुणों के साथ।
list_funnels	सहेजे गए फ़नल उनके चरणों के साथ (run_funnel के लिए funnelId प्राप्त करें)।
run_funnel	सहेजे गए funnelId या एड-हॉक पेज/इवेंट चरणों से रूपांतरण फ़नल।
get_goals	सहेजे गए लक्ष्य रूपांतरण, विज़िटर और दर के साथ एक सीमा के लिए।
run_journey	विज़िटरों द्वारा लिए जाने वाले सबसे सामान्य पथ।
run_retention	कोहोर्ट प्रतिधारण तालिका।
run_attribution	रूपांतरण के लिए पहला/अंतिम-क्लिक एट्रिब्यूशन।
get_revenue	राजस्व कुल, श्रृंखला और विभाजन।
get_performance	कोर वेब विटल्स (LCP, INP, CLS, FCP, TTFB) प्रतिशतक, प्रवृत्ति, विभाजन।

सभी टूल केवल-पठनीय हैं। तिथियाँ ISO 8601 हैं; परिणाम पेजिनेटेड हैं और पेज आकार पर कठोर सीमा है।

रिमोट: Umami क्लाउड

अपनी मौजूदा क्लाउड API कुंजी का उपयोग करके https://cloud.umami.is/mcp से कनेक्ट करें:

Authorization: Bearer api_<your-cloud-api-key>

कस्टम हेडर का समर्थन करने वाले क्लाइंट x-umami-api-key का उपयोग कर सकते हैं। यदि दोनों हेडर प्रदान किए गए हैं, तो उनमें समान कुंजी होनी चाहिए। ऐसे क्लाइंट का उपयोग करें जो API-कुंजी या बियरर-हेडर कॉन्फ़िगरेशन का समर्थन करता हो।

क्लाउड MCP की सदस्यता आवश्यकताएँ और वेबसाइट/टीम अनुमतियाँ क्लाउड API के समान हैं। सभी टूल क्लाउड API गेटवे को कॉल करते हैं, जो कुंजी को मान्य करता है और अनुरोधों को आपके क्षेत्र में रूट करता है।

रिमोट: सेल्फ-होस्टेड

अपने Umami इंस्टेंस में सेटिंग्स → API कुंजियाँ के तहत एक API कुंजी उत्पन्न करें, फिर अपने MCP क्लाइंट को Streamable HTTP एंडपॉइंट के साथ कॉन्फ़िगर करें:

https://your-umami.example.com/mcp

अपनी कुंजी का उपयोग करके प्राधिकरण हेडर सेट करें:

Authorization: Bearer umami_<your-api-key>

ऐसे क्लाइंट का उपयोग करें जो बियरर टोकन या कस्टम प्राधिकरण हेडर का समर्थन करता हो। एंडपॉइंट सेल्फ-होस्टेड API कुंजियाँ स्वीकार करता है; ब्राउज़र लॉगिन टोकन समर्थित नहीं हैं। टूल केवल-पठनीय हैं और कुंजी स्वामी की मौजूदा उपयोगकर्ता/टीम अनुमतियों का सम्मान करते हैं। पहुँच डिस्कनेक्ट करने के लिए सेटिंग्स में कुंजी रद्द करें। MCP डिफ़ॉल्ट रूप से अक्षम है। एंडपॉइंट सक्षम करने के लिए MCP_ENABLED=1 सेट करें।

स्थानीय / stdio

{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@umami/mcp"],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_API_TOKEN": "umami_…"
      }
    }
  }
}

चर	विवरण
UMAMI_URL	सेल्फ-होस्टेड इंस्टेंस URL (/api जोड़ा जाता है)।
UMAMI_API_URL	इसके बजाय पूर्ण API बेस URL, जैसे https://api.umami.is/v1।
UMAMI_API_TOKEN	API कुंजी या लॉगिन टोकन (सेल्फ-होस्टेड)।
UMAMI_API_KEY	Umami क्लाउड API कुंजी।

क्लाउड stdio के लिए, UMAMI_API_KEY सेट करें और UMAMI_URL और UMAMI_API_TOKEN छोड़ दें:

{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@umami/mcp"],
      "env": { "UMAMI_API_KEY": "api_<your-cloud-api-key>" }
    }
  }
}

उदाहरण प्रॉम्प्ट

• मेरी वेबसाइटें दिखाएँ।
• पिछले सप्ताह example.com को कितने विज़िटर मिले?
• इस महीने के शीर्ष 10 पेज क्या थे?
• इस महीने के ट्रैफ़िक की तुलना पिछले महीने से करें।
• ट्रैफ़िक कहाँ से आ रहा है?
• कल कौन से साइनअप इवेंट हुए?
• उपयोगकर्ता abc123 के सत्र दिखाएँ।
• पिछले महीने चेकआउट इवेंट में लोगों ने कौन सी मूल्य निर्धारण योजनाएँ चुनीं?
• इस सप्ताह प्रतिदिन कितने साइनअप इवेंट हुए?
• पिछले महीने के लिए मेरा चेकआउट फ़नल चलाएँ।
• इस तिमाही में हम अपने लक्ष्यों के विरुद्ध कैसा कर रहे हैं?
• मोबाइल पर किन पेजों का LCP सबसे खराब है?
• ट्रैफ़िक बढ़ने के दिन क्या हुआ?

प्रोग्रामेटिक उपयोग

import { UmamiClient } from '@umami/api-client';
import { createUmamiMcpServer } from '@umami/mcp';

const server = createUmamiMcpServer({
  client: new UmamiClient({ baseUrl, token }),
});

createUmamiMcpHttpHandler({ createClient }) किसी भी वेब फ्रेमवर्क में एम्बेड करने के लिए एक Streamable HTTP हैंडलर लौटाता है; होस्ट बियरर टोकन सत्यापित करता है और authInfo पास करता है।