# Plausible MCP > Plausible connects your website analytics directly to any AI agent. Get real-time insights on active visitors, total pageviews, and bounce rates without logging into a separate dashboard. Use natural conversation to pull aggregate stats for 30 days, track traffic trends over time, or break down performance by country, browser, and device. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** privacy-focused, web-analytics, cookieless, gdpr-compliance, real-time-metrics, website-performance ## Description Stop clicking through tabs just to figure out where your traffic is coming from. This MCP connects Plausible Analytics directly to your agent, letting you run complex web performance reports using plain conversation. Need to know how many people are on your site right now? You can ask for it. Want to see if your last campaign worked? You can pull total visitors and bounce rates for the last 7 days in a single query. The power is in the detail: you can analyze traffic trends over time, or break down stats by top sources, countries, or even specific custom properties. Connecting this via Vinkius means you don't need to switch tools. You just keep working inside your chat interface. It’s all about getting instant, actionable data on who is visiting and what they are doing. ## Tools ### get_aggregate_stats Pulls overall site statistics, such as total visitors and bounce rates, for a specified time period. ### get_custom_breakdown Provides detailed stats broken down by any specific property you've customized in Plausible. ### get_realtime_visitors Returns the exact count of people currently active and viewing your site right now. ### get_timeseries_stats Generates a time-based view, showing how various site statistics have changed over a period. ### get_top_browsers Lists the types of web browsers that are visiting your website. ### get_top_countries Shows which countries send the most traffic to your site. ### get_top_devices Determines whether visitors are primarily using mobile phones, tablets, or desktop computers. ### get_top_os Lists the operating systems (like Windows or macOS) used by your visitors. ### get_top_pages Identifies and ranks the pages on your site that receive the most views. ### get_top_sources Reveals where your traffic is coming from, whether it's Google, social media, or direct links. ## Prompt Examples **Prompt:** ``` How many visitors are on my site right now? ``` **Response:** ``` There are currently 12 active visitors on your site. ``` **Prompt:** ``` Show me the top 5 pages by traffic for the last 7 days. ``` **Response:** ``` I've retrieved the top pages. The most visited are: 1. Home (/), 2. Pricing (/pricing), 3. Features (/features), 4. Blog (/blog/new-launch), and 5. Contact (/contact). ``` **Prompt:** ``` What was my bounce rate for the last 30 days? ``` **Response:** ``` Your aggregate bounce rate for the last 30 days was 42.5%. ``` ## Capabilities ### Get live visitor count Check the current number of people actively browsing your site. ### Analyze historical performance Retrieve total visitors, pageviews, and bounce rates for specific date ranges like 30 days or last week. ### Track traffic flow over time Get data points showing how your site's traffic volume has changed across multiple periods. ### Segment user demographics Break down visitor stats by top sources, countries, operating systems, and devices used. ### Deep dive into site content See which specific pages are the most viewed or analyze data based on custom properties you track. ## Use Cases ### A campaign failed, but you don't know why. The marketer asks: 'What was the bounce rate for my key landing page in the last 7 days?' The agent uses `get_aggregate_stats` and `get_top_pages`, revealing a high bounce rate on that specific URL. This tells them they need to rewrite the copy before spending more ad money. ### Need to prepare for an executive meeting. The product manager asks: 'Give me a breakdown of traffic by country and device type.' The agent runs `get_top_countries` and `get_top_devices`, providing the C-suite with immediate, global user segmentation data without opening any dashboards. ### Checking site health before launch. The developer asks: 'How many people are currently on the staging site?' The agent calls `get_realtime_visitors`, confirming if traffic is flowing correctly and providing a live count for QA sign-off. ### Understanding user engagement trends. The team lead asks: 'Show me how my total visitors have changed over the last six months.' The agent uses `get_timeseries_stats`, visualizing the trend and pinpointing exactly when traffic spiked or dropped. ## Benefits - Instant insights into live traffic. Instead of logging in to see the visitor count, simply ask your agent for 'current active visitors' using `get_realtime_visitors` and get an immediate number. - Full historical data access. Need to know if Q2 was better than Q1? Use `get_aggregate_stats` to pull total bounce rates or pageviews across any defined time window, fast. - Pinpoint traffic sources immediately. Don't guess where your leads come from. Running a query using `get_top_sources` shows you exactly which platforms are sending the most people. - Deep user behavior analysis. Instead of just seeing total stats, run `get_custom_breakdown` to analyze how users interact with specific features or content types. - See who is visiting and how. Use `get_top_countries`, `get_top_devices`, and `get_top_os` together in one prompt to understand your global user base's tech stack. ## How It Works The bottom line is you talk to your agent about your site data, and it pulls the stats immediately. 1. Subscribe to this MCP and enter your Plausible API Key along with your Site ID (domain). 2. Select this tool within any compatible AI client, like Cursor or Claude. 3. Ask a question in natural language, such as 'What was the bounce rate for last month?' ## Frequently Asked Questions **How do I find out my current visitor count using Plausible MCP?** You use the `get_realtime_visitors` tool. Just ask your agent, 'What is the current active visitor count?' It gives you a live number without needing any setup. **Can I check my bounce rate for different periods with Plausible MCP?** Yes, use `get_aggregate_stats`. You can specify date ranges like 'last 30 days' or 'yesterday' to get the accurate bounce rate and other key metrics. **How do I analyze traffic sources with Plausible MCP?** Use `get_top_sources`. You can ask your agent for a breakdown of where visitors are coming from, whether it's social media or search engines. **Is Plausible MCP good for seeing user demographics?** It is. You combine tools like `get_top_countries`, `get_top_devices`, and `get_top_os` to get a comprehensive view of your audience's technical setup globally. **Can I track site performance over many months with Plausible MCP?** Yes, use `get_timeseries_stats`. This tool tracks trends and shows how key metrics have evolved across a set period, making seasonality easy to spot.