How to Use the GoatCounter MCP in Cursor

Q: How do I add the GoatCounter MCP server to my Cursor configuration?

Add the server details to your .cursor/mcp.json file in your project root or global directory. Once saved, enable Agent mode in the chat panel to let the editor access the tools.

Q: Can the Cursor agent export my entire GoatCounter database?

Yes. Your agent can trigger startexport and download the raw CSV or JSON data using downloadexport directly into your project workspace for local analysis.

Q: How do I check if my API connection is working in Cursor?

Ask the agent to run the getme tool. It will return your account details and confirm that your workspace has valid read and write permissions.

Feed real-time visitor metrics directly into your Cursor agent to build data-driven layouts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GoatCounter MCP to Cursor

Create your Vinkius account to connect GoatCounter to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup GoatCounter with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inject live traffic data into your code

The GoatCounter MCP server feeds real-time traffic statistics directly into your active editor session using `get_stats_hits`. Your agent pulls active pageview counts to write dynamic dashboard components based on live numbers. Use `get_stats_page` to fetch specific breakdowns like browser types or operating systems. This lets your agent generate realistic mock data or optimize UI code for your actual audience profiles.

Automate site provisioning with Cursor

This MCP server lets Cursor handle your tracking setup using `create_site` and `update_site` during development. When spinning up a new project, your agent can register the site with your analytics provider automatically. Verify the registration succeeded by calling `list_sites` or retrieving details with `get_site`. You never have to leave your code editor to configure tracking for a new staging environment.

Track local development events directly

Run `count_hits` to dispatch test events and pageviews from your local runtime straight to your analytics dashboard. This makes it easy to test custom event tracking setups before deploying code to production. Confirm the events went through by calling `get_stats_total` inside your chat sidebar. You get immediate feedback on whether your tracking tags are firing correctly.

Setup guide

Set up GoatCounter MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the GoatCounter MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent GoatCounter transactions." If the MCP tools are loaded correctly, Cursor will call the GoatCounter tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "goatcounter-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by GoatCounter. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect GoatCounter now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about GoatCounter MCP in Cursor

Add the server details to your `.cursor/mcp.json` file in your project root or global directory. Once saved, enable Agent mode in the chat panel to let the editor access the tools.

Yes. Your agent can trigger `start_export` and download the raw CSV or JSON data using `download_export` directly into your project workspace for local analysis.

It keeps you in the flow state. Instead of context-switching to a browser tab, your agent pulls real-world visitor metrics to inform your styling and feature decisions.

Ask the agent to run the `get_me` tool. It will return your account details and confirm that your workspace has valid read and write permissions.

Absolutely. Your API keys and configuration data are isolated inside Vinkius's zero-trust environment. No credentials or raw analytics databases are ever exposed to third parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript