developer-toolsapi_key

Plausible Analytics

Privacy-focused web analytics platform that provides simple, lightweight, and GDPR-compliant website statistics

Verdict

Plausible Analytics tracks website visitors without cookies or personal data collection. When you @mention Plausible in a Space, your team can pull traffic stats, compare time periods, break down visitor sources, and check real-time counts — all without leaving the conversation. Marketing teams use it to report campaign performance during standups; product managers pull page-view trends to prioritize features; support teams check traffic spikes when investigating incidents. You'll need an API key from your Plausible account, and the MCP only accesses sites you've already configured in Plausible. Custom properties require an Enterprise plan.

Common use cases

  • Report weekly traffic trends in standups
  • Compare campaign performance across channels
  • Investigate traffic spikes during incidents
  • Audit top landing pages for content strategy
  • Monitor real-time visitor counts before launches

Integration

Vendor
Plausible Analytics
Category
developer-tools
Auth
API_KEY
Tools
14
Composio slug
plausible_analytics

Tools

  • Check API Health

    Tool to check the health status of the Plausible Analytics API. Use when verifying API connectivity and service availability before making other API calls.

  • Get Aggregate Stats

    Tool to retrieve aggregated metrics for a given time period from Plausible Analytics. Use this to get summary statistics like total visitors, pageviews, bounce rate, and visit duration. This is the legacy Stats API v1 endpoint for querying

  • Get Breakdown Stats

    Tool to retrieve breakdown statistics for a specific property (dimension) from Plausible Analytics. Use when you need to analyze top sources, top pages, device breakdown, geographic distribution, or any other dimensional breakdown of your s

  • Get Plugin Capabilities

    Tool to retrieve available capabilities for the Plausible Analytics Plugins API. Use this to check which features are enabled for the authenticated account, such as Goals, Funnels, Stats API, and more.

  • Get Realtime Visitors

    Tool to retrieve the number of current visitors on your site in the last 5 minutes. Use this to get real-time visitor counts from the Plausible Analytics Stats API v1.

  • Get Site Details

    Tool to retrieve details for a specific Plausible Analytics site. Use when you need site configuration including domain, timezone, custom properties, and tracker script settings.

  • Get Timeseries Stats

    Tool to retrieve timeseries visitor data from Plausible Analytics over a specified time period. Use this to get historical trends for metrics like visitors, pageviews, bounce rate, and visit duration. This is the legacy Stats API v1 endpoin

  • List Custom Properties

    Tool to list all custom properties configured for a site. Use when you need to retrieve custom property configurations for a Plausible Analytics site. Enterprise feature only.

  • List Goals

    Tool to list all goals configured for a site. Use when you need to retrieve conversion goals and custom action tracking configured for a Plausible Analytics site.

  • List Site Guests

    Tool to list all guest users who have access to a site's dashboard in Plausible Analytics. Use when you need to see which guests have been granted access to view a specific site's analytics. This is an Enterprise feature.

  • List Sites

    Tool to list all sites the API key owner's Plausible account can access. Returns domain, timezone, and creation info with pagination support. Use when you need to retrieve all sites or paginate through large site lists.

  • List Teams

    Tool to list all teams available for the API key owner. Use when you need to retrieve teams for site provisioning to a specific team.

  • Query Analytics Stats

    Tool to query analytics stats for a site using the Stats API v2. Use when you need to retrieve historical or real-time statistics such as visitors, pageviews, bounce rate, visit duration, and more. Supports filtering, grouping by dimensions

  • Record Event

    Tool to record a pageview or custom event via the Plausible Events API. Use when tracking Android/iOS mobile apps or server-side tracking. Requires proper User-Agent and optionally X-Forwarded-For headers for unique visitor counting.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Find Plausible Analytics in the MCP directory and click Connect. 3. Log into your Plausible Analytics account at plausible.io and go to Settings > API Keys. 4. Generate a new API key with read access to the sites you want to query. 5. Copy the key and paste it into the Switchy connection dialog, then click Authorize. 6. Switchy confirms the connection by checking API health and listing your sites. 7. Open any Space and type '@Plausible get aggregate stats for example.com last 30 days' to test — you should see visitor counts, pageviews, bounce rate, and average session duration. 8. If you see an authentication error, verify the API key has not expired and that the site domain matches exactly what appears in your Plausible dashboard.

What teammates see: by default, memories from Plausible Analytics are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Weekly Traffic Summary

@Plausible get aggregate stats for our main site over the last 7 days, including visitors, pageviews, bounce rate, and visit duration
Open in a Space →

Top Referral Sources

@Plausible show me a breakdown of referral sources for our site in the last 30 days, sorted by visitor count
Open in a Space →

Real-Time Visitor Check

@Plausible how many visitors are on our site right now?
Open in a Space →

Month-Over-Month Comparison

@Plausible compare aggregate stats for our site between last month and this month, focusing on visitors and pageviews
Open in a Space →

Top Pages Report

@Plausible give me a breakdown of top pages for our site in the last 14 days, ordered by pageviews
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@plausible show me a 30-day breakdown of traffic sources for my-app.com, sorted by visitor count

Output

Based on the last 30 days of data for my-app.com, here's your traffic source breakdown: Direct traffic accounts for 3,847 visitors (42%), followed by Google organic search with 2,156 visitors (24%), Twitter referrals at 1,423 visitors (16%), GitHub at 891 visitors (10%), and other sources totaling 683 visitors (8%). Your bounce rate from direct traffic is notably lower (31%) compared to social referrals (58%), suggesting direct visitors engage more deeply with your content.

Notes

This example demonstrates the Get Breakdown Stats tool, which segments your analytics by dimensions like source, page, country, or device. Requires read access to the Stats API. The breakdown respects your site's timezone setting and can filter by custom properties if you're on an Enterprise plan.

Prompt

@plausible create a goal called 'signup_completed' for my-app.com and tell me how many times it fired in the last 7 days

Output

I've created the 'signup_completed' goal for my-app.com. However, goal creation through the API requires the goal to be triggered by your site's tracking code before historical data becomes available. Since this is a new goal, there's no historical data for the past 7 days yet. Once your site starts sending 'signup_completed' events via the Plausible script, you'll be able to query conversion counts and analyze signup funnel performance.

Notes

This example shows a write operation followed by a read attempt, illustrating an important limitation: newly created goals won't have retroactive data. The MCP can create goals via the Sites API, but your frontend must instrument the tracking events. Goals are a paid feature, and you'll need both Sites API and Stats API access to create and query them.

Prompt

@plausible compare this week's visitor trends to last week for my-app.com and explain any significant changes you notice

Output

Pulling timeseries data for my-app.com: This week (Dec 9-15) averaged 487 daily visitors compared to 412 last week (Dec 2-8), a 18% increase. The spike occurred primarily on Tuesday and Wednesday, coinciding with your Product Hunt launch mentioned in referral data. Bounce rate improved from 52% to 47%, and average visit duration increased from 1m 24s to 1m 51s. However, Thursday-Friday showed a 23% drop-off, returning closer to your baseline. This suggests the launch drove quality traffic initially, but sustained engagement will require follow-up content or campaigns.

Notes

This example combines Get Timeseries Stats with the AI's analytical reasoning to surface insights across multiple metrics. The MCP provides raw timeseries data; the AI interprets patterns and correlates them with breakdown stats (like referral sources). Timeseries queries can span up to 12 months but become slower with finer granularity (hourly vs. daily intervals).

Use-case deep-dives

Marketing campaign attribution for SaaS

When Plausible wins for privacy-first campaign tracking

A 6-person SaaS marketing team runs weekly campaigns across Twitter, Product Hunt, and email. They need to see which sources drive signups without violating GDPR or slowing down their site with Google Analytics. Plausible's breakdown stats tool segments traffic by source and referrer in under 2 seconds, and the aggregate stats tool pulls conversion metrics for custom goals (like 'trial_started') without cookies. The API key auth means any team member can query data from Slack or a dashboard without OAuth friction. This setup works until you need session replay or user-level funnels—Plausible tracks events, not individual user journeys. If your campaigns generate under 10k monthly visits and you care about compliance, this MCP is the right call for daily standup reporting.

Real-time traffic monitoring for launches

Use this MCP to watch Product Hunt spikes live

A 3-person product team launches on Product Hunt at 8am Pacific. They need to see visitor counts every 5 minutes to decide whether to boost the post or fix a landing page bug. The realtime visitors tool hits Plausible's API and returns current traffic in a single call—no dashboard tab-switching, no 30-second GA delays. The timeseries stats tool graphs the last 24 hours so they can compare this launch to last month's. This works because Plausible's API is fast and the team only needs top-level metrics during the launch window. If you need to drill into individual user sessions or A/B test variants in real time, this MCP won't help—it's aggregated data only. For launch-day traffic watching at small scale, Plausible's speed and simplicity beat heavier tools.

Content performance review for editorial teams

When Plausible handles weekly content retrospectives

A 5-person editorial team publishes 12 blog posts a month and reviews performance every Friday. They need to see which posts drove the most traffic, how long readers stayed, and which external sites linked in. The breakdown stats tool pulls top pages ranked by visitors, and the aggregate stats tool shows average visit duration and bounce rate for the past 7 days. The API returns clean JSON that feeds directly into a Notion database or Slack summary—no manual CSV exports. This setup breaks down if you need scroll depth, heatmaps, or per-paragraph engagement; Plausible tracks page-level metrics, not in-page behavior. For teams under 50k monthly pageviews who want fast, privacy-compliant content analytics without the Google Analytics learning curve, this MCP is the move.

Frequently asked

What does the Plausible Analytics MCP do in Switchy?

It pulls your website analytics data into Switchy's AI workspace. Your team can query visitor counts, page breakdowns, traffic sources, and real-time stats without opening the Plausible dashboard. The MCP uses 14 tools covering aggregated metrics, timeseries trends, geographic breakdowns, and site configuration. You can ask questions like 'show me top pages this week' or 'how many visitors right now' and get structured answers from your Plausible account.

Do I need admin access to connect Plausible Analytics?

You need an API key from your Plausible account, which requires owner or admin permissions to generate. Go to your Plausible settings, create a new API key, and paste it into Switchy's MCP connection form. The key grants read access to all sites in your account. If you only have viewer permissions on a site, you can't generate the key yourself—ask the account owner to create one and share it with you.

Can the Plausible MCP create goals or funnels?

No. The MCP is read-only—it retrieves analytics data but doesn't modify your Plausible configuration. You can query whether goals and funnels exist using the Get Plugin Capabilities tool, and you can pull goal conversion stats if they're already set up. To create or edit goals, funnels, or custom properties, you still need to use the Plausible web interface. This keeps your analytics setup safe from accidental AI changes.

How does this compare to exporting CSV reports from Plausible?

The MCP is faster for ad-hoc questions and combines data across timeframes or properties without manual exports. Instead of downloading CSVs and opening spreadsheets, you ask Switchy 'compare mobile vs desktop traffic last month' and get an answer in seconds. The trade-off is you can't do custom pivot tables or formulas—if you need heavy Excel manipulation, export the CSV. For quick insights and team collaboration, the MCP wins.

Who on the team should connect the Plausible MCP?

Whoever owns your Plausible account or has admin access to generate API keys. Once connected in Switchy, anyone in your workspace can query the analytics data—they don't need their own Plausible login. This is useful for giving marketers, designers, or support staff access to traffic insights without handing out Plausible seats. The MCP doesn't count against Plausible's plan limits; it just uses your existing API quota.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.