Plausible MCP by usefulapi

Name: Plausible MCP by usefulapi
Author: usefulapi.io

远程服务

usefulapi.io数据与分析0今天更新

代码仓库访问官网

关于 Plausible MCP by usefulapi

这款托管 MCP 服务面向 Plausible Analytics 用户，可在 MCP 客户端中查询网站指标。无需本地安装，支持统计数据、实时访客、属性细分和目标。

主要功能

01网站统计与汇总
02时间序列查询
03按属性细分数据
04实时访客数量
05网站与目标列表

适用场景

01跟踪选定时间段的网站指标
02查看当前实时访客数量
03按属性比较指标
04检查已配置的目标

MCP 相关

向 MCP 客户端提供 Plausible 网站统计、汇总、时间序列、细分、实时访客和目标的只读工具。服务托管于远程端点，并通过 OAuth 使用用户的 Plausible API key 登录。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://plausible-analytics.usefulapi.io/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http io-usefulapi-plausible-analytics https://plausible-analytics.usefulapi.io/mcp

Cursor.cursor/mcp.json{"mcpServers":{"io-usefulapi-plausible-analytics":{"type":"http","url":"https://plausible-analytics.usefulapi.io/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"io-usefulapi-plausible-analytics":{"type":"http","url":"https://plausible-analytics.usefulapi.io/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"io-usefulapi-plausible-analytics":{"type":"http","url":"https://plausible-analytics.usefulapi.io/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"io-usefulapi-plausible-analytics":{"serverUrl":"https://plausible-analytics.usefulapi.io/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
filters	array	否	可选筛选条件。每个条件都是一个数组，例如 ["is","visit:country_name",["Estonia"]] 或 ["contains","event:page",["/blog"]]，逻辑包装器为 ["and",[...]] / ["or",[...]] / ["not",[...]]。运算符：is、is_not、contains、contains_not、matches、matches_not、has_done、has_not_done。
include	object	否	可选的包含标志：{ imports?, time_labels?, total_rows? }。
include.imports	boolean	否	包含导入的（Plausible 之前的）统计数据。
include.total_rows	boolean	否	在 meta 中包含行总数。
include.time_labels	boolean	否	包含该范围的完整时间标签列表。
metrics	array	是	要计算的指标。可选值：visitors、visits、pageviews、views_per_visit、bounce_rate、visit_duration、events、scroll_depth、percentage、conversion_rate、group_conversion_rate、average_revenue、total_revenue、time_on_page。
site_id	string	是	在 Plausible 中注册的网站域名，例如 "example.com"。
order_by	array	否	可选排序：由 [metric_or_dimension, "asc"\|"desc"] 对组成的数组，例如 [["visitors","desc"]]。
date_range	any	是	日期范围：快捷字符串（"day", "7d", "28d", "30d", "91d", "month", "6mo", "12mo", "year", "all", "24h"）或包含 2 个元素的 ISO8601 数组，例如 ["2024-01-01","2024-07-01"]（日期或带时区的日期时间）。
dimensions	array	否	分组维度。事件维度（event:goal、event:page、event:hostname）、访问维度（visit:source、visit:referrer、visit:utm_medium/source/campaign、visit:device、visit:browser、visit:os、visit:country/region/city[_name]、visit:entry_page、visit:exit_page）、时间维度（time、time:hour、time:day、time:week、time:month）或自定义属性（event:props:<name>）。省略则返回总计。
pagination	object	否	可选分页：{ limit?, offset? }。
pagination.limit	integer	否	每页行数（默认值为 10000）。
pagination.offset	integer	否	行偏移量（默认值为 0）。

详细介绍

usefulapi 提供的 Plausible MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Plausible 账户——查询网站统计数据、实时访客、细分数据和目标。托管服务，无需本地安装：使用你自己的凭据连接。

实时端点： https://plausible-analytics.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://plausible-analytics.usefulapi.io/mcp。
Claude Code： claude mcp add --transport http plausible-analytics https://plausible-analytics.usefulapi.io/mcp，然后运行 /mcp 登录。
VS Code： 添加到 VS Code。
Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "plausible-analytics": {
      "url": "https://plausible-analytics.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Plausible 凭据。

分步设置说明、凭据查找方式和常见问题解答：https://usefulapi.io/plausible-analytics/

首次连接时，你需要提供 Plausible API 密钥（Account Settings → API keys）。密钥经过验证，按用户存储并仅限你本人使用——配置文件中不会保存密钥。

工具

工具	类型	功能
`plausible_query_stats`	read	查询统计数据
`plausible_aggregate`	read	汇总总计
`plausible_timeseries`	read	时间序列
`plausible_breakdown`	read	按属性细分
`plausible_realtime_visitors`	read	实时访客
`plausible_list_sites`	read	列出网站
`plausible_get_site`	read	获取网站
`plausible_list_goals`	read	列出目标
`plausible_analytics_usage_status`	meta	使用情况（免费套餐用量计数）
`plausible_analytics_request_feature`	meta	申请添加缺失功能
`plausible_analytics_upgrade`	meta	升级到 Pro（无限*）
`plausible_analytics_cancel_subscription`	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告使用情况、管理订阅或发送功能申请。

定价

套餐	价格	限制
免费	$0	每月 50 次工具调用
Pro	$9/mo 或 $90/yr（免费 2 个月）	无限*

*Pro 在此服务上的公平使用限制为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 plausible_analytics_upgrade 订阅（它会返回 Stripe Checkout 链接）。你可以随时使用 plausible_analytics_cancel_subscription 取消：Pro 会持续到已付费周期结束，当前周期不予退款；在此之前运行 plausible_analytics_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。