goatcounter-mcp-server
If you are the rightful owner of goatcounter-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Goatcounter MCP Server allows interaction with the Goatcounter web analytics API using a standardized tool interface, facilitating easy querying of statistics and information.
The Goatcounter MCP Server is a Model Context Protocol server designed to interface with the Goatcounter web analytics API. Built using Python and the FastMCP library, it enables language models and other MCP clients to query Goatcounter statistics efficiently. The server reads the Goatcounter site code and API key from environment variables for authentication, ensuring secure and streamlined access. It supports lazy initialization of the API client, allowing tools to be listed even if API credentials are not yet configured. The server also implements rate limit handling with automatic retries and backoff strategies, ensuring robust performance even under API constraints. Users can run the server directly using the fastmcp command-line tool, making it accessible and easy to integrate into various workflows.
Features
- Provides tools for most Goatcounter API endpoints.
- Handles API key and site code configuration via environment variables.
- Lazy initialization of the API client.
- Rate Limit Handling with automatic retries and backoff.
- Runs directly using the fastmcp command-line tool.
Tools
Goatcounter_get_me
Get information about the current Goatcounter user and API key
Goatcounter_list_sites
List all Goatcounter sites that are accessible to the current API key
Goatcounter_list_paths
Get an overview of the site tracking path (no statistics)
Goatcounter_get_stats_total
Gets the total page views and number of independent visitors to the site during a specified time period
Goatcounter_get_stats_hits
List page statistics (page views and visitors per path)
Goatcounter_get_stats_refs
List the statistics of referral sources
Goatcounter_get_stats_browsers
List browser statistics
Goatcounter_get_stats_systems
List operating system statistics
Goatcounter_get_stats_sizes
List screen size statistics
Goatcounter_get_stats_locations
List location statistics
