GoatCounter MCP Server for Mastra AIGive Mastra AI instant access to 14 tools to Count Hits, Create Site, Download Export, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect GoatCounter through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The GoatCounter MCP Server for Mastra AI is a standout in the Productivity category — giving your AI agent 14 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"goatcounter": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "GoatCounter Agent",
instructions:
"You help users interact with GoatCounter " +
"using 14 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with GoatCounter?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About GoatCounter MCP Server
Connect your GoatCounter account to any AI agent to monitor your web traffic without compromising user privacy. This MCP server allows you to query detailed statistics, manage site configurations, and handle data exports through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and GoatCounter tool infrastructure. Connect 14 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Traffic Insights — Retrieve pageview counts, total hits, and referral statistics for specific paths.
- Visitor Analytics — Break down stats by categories such as browsers, operating systems, locations, and languages.
- Data Portability — Initiate, monitor, and download full CSV/JSON data exports for external analysis.
- Site Management — List all your registered sites, create new ones, or update existing site configurations.
- Custom Event Tracking — Send hits or events directly from your backend or middleware to your GoatCounter dashboard.
The GoatCounter MCP Server exposes 14 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 14 GoatCounter tools available for Mastra AI
When Mastra AI connects to GoatCounter through Vinkius, your AI agent gets direct access to every tool listed below — spanning web-analytics, privacy-focused, traffic-monitoring, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Count hits on GoatCounter
Send pageviews or events to GoatCounter
Create site on GoatCounter
Create a new site
Download export on GoatCounter
Download a completed export file
Get export on GoatCounter
Get export status and metadata
Get me on GoatCounter
Get current user and API key info
Get site on GoatCounter
Detailed information about a site
Get stats hits on GoatCounter
Overview of pageviews per path
Get stats hits path on GoatCounter
Referral statistics for a specific path
Get stats page on GoatCounter
Stats for specific categories (browsers, systems, etc)
Get stats page detail on GoatCounter
g., browser versions). Detailed stats for a specific item in a category
Get stats total on GoatCounter
Total pageview counts for a date range
List sites on GoatCounter
List all sites accessible by the user
Start export on GoatCounter
Returns an export ID to check status. Start a new data export in the background
Update site on GoatCounter
Update site settings
Connect GoatCounter to Mastra AI via MCP
Follow these steps to wire GoatCounter into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the GoatCounter MCP Server
Mastra AI provides unique advantages when paired with GoatCounter through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add GoatCounter without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every GoatCounter tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
GoatCounter + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the GoatCounter MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query GoatCounter, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed GoatCounter as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query GoatCounter on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using GoatCounter tools alongside other MCP servers
Example Prompts for GoatCounter in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with GoatCounter immediately.
"Show me the total pageview counts for the last 30 days."
"List all the sites registered in my GoatCounter account."
"Get detailed stats for browser versions used by my visitors."
Troubleshooting GoatCounter MCP Server with Mastra AI
Common issues when connecting GoatCounter to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpGoatCounter + Mastra AI FAQ
Common questions about integrating GoatCounter MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
LangSmith (LLM Observability & Hub)
6 toolsMonitor LLM apps via LangSmith — track traces, audit prompt templates, and manage evaluation datasets.
MerchantSpring
10 toolsCross-marketplace reporting via MerchantSpring — track sales, orders, and products from multiple stores.
FatSecret
2 toolsAccess millions of food items with calorie tracking, macro data, and serving sizes from the FatSecret platform used by 30M+ users worldwide.
IBGE Pesquisas — Brasil Cidades
4 toolsQuery the engine behind Brasil Cidades: health, education, economy, and quality-of-life indicators for every Brazilian municipality — rank cities, compare regions, and build data-driven policy analysis.