How to Use the GoatCounter MCP in Windsurf

Q: How do I configure the GoatCounter MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Cascade will automatically discover all 14 analytics tools the next time you open the editor.

Q: How does Windsurf handle large data exports from GoatCounter?

Cascade triggers the export with startexport, polls for status, and then uses downloadexport to save the file locally. It manages the whole multi-step sequence without you needing to monitor the download.

Track your site traffic and manage privacy-first analytics directly inside your Windsurf IDE with Cascade.

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 Windsurf

Create your Vinkius account to connect GoatCounter to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Cascade build live traffic reports inside Windsurf

Cascade can chain operations together to pull your raw GoatCounter visitor data without you running manual API queries. By calling `get_stats_total` and `get_stats_hits`, the agent grabs your latest traffic numbers, formats them, and presents them directly in your Windsurf workspace. If you need to dig deeper into specific paths, Cascade uses `get_stats_hits_path` to find where your GoatCounter visitors are coming from. It does all of this autonomously inside Windsurf, letting you focus on writing code instead of digging through web analytics dashboards.

Manage multiple GoatCounter sites without leaving the IDE

Managing GoatCounter client sites or side projects gets simple when your Windsurf editor handles the configuration. This MCP Server lets your editor list all active projects using `list_sites` or inspect a specific setup with `get_site`. When you need to spin up a new tracker, Cascade calls `create_site` and updates settings via `update_site` in a single Windsurf run. You get instant GoatCounter configuration changes without opening a browser tab.

Export raw analytics data straight to your workspace

When aggregate numbers aren't enough, you can trigger full raw GoatCounter data dumps directly through your Windsurf editor. This MCP Server lets Cascade kick off a background data export using `start_export` and monitor the progress with `get_export`. Once the export finishes, Windsurf pulls down the clean CSV file via `download_export` and saves it to your workspace. You can immediately run local Python scripts or SQL queries on the raw GoatCounter data inside your editor.

Setup guide

Set up GoatCounter MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the GoatCounter MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my GoatCounter payment history." If connected, Cascade will call the GoatCounter tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Cascade will automatically discover all 14 analytics tools the next time you open the editor.

Yes. You can tell Cascade to set up traffic tracking, and it will write the tracking code and use `count_hits` to send test pageviews directly to your GoatCounter dashboard to verify the integration.

Cascade triggers the export with `start_export`, polls for status, and then uses `download_export` to save the file locally. It manages the whole multi-step sequence without you needing to monitor the download.

You can ask Cascade to modify your site configurations directly. It uses `update_site` to change settings like your domain or public access rules without requiring you to log into the web UI.

All communication happens over an encrypted connection directly between Windsurf and the API. Your actual visitor pageviews and browser stats are never sent to third-party servers, keeping your analytics private and compliant.

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