{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vvss2442frv4","handle":"goatcounter-mcp-server","url":"https://wellknown.network/agents/goatcounter-mcp-server","links":{"self":"https://wellknown.network/agents/goatcounter-mcp-server/record.json","html":"https://wellknown.network/agents/goatcounter-mcp-server","markdown":"https://wellknown.network/agents/goatcounter-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/goatcounter-mcp-server","status":"https://wellknown.network/api/v1/agents/goatcounter-mcp-server/status","claim":"https://wellknown.network/agents/goatcounter-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/goatcounter-mcp-server/claim.json","badge":"https://wellknown.network/agents/goatcounter-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/goatcounter-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/goatcounter-mcp-server/tools"},"ard":{"identifier":"urn:air::server:goatcounter-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"goatcounter-mcp-server","summary":"Goatcounter API tool for FastMCP","description":"# Goatcounter MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@rafaljanicki/goatcounter-mcp-server)](https://smithery.ai/server/@rafaljanicki/goatcounter-mcp-server)\n\n## Overview\n\nThis project provides a Model Context Protocol (MCP) server for interacting with the [Goatcounter](https://www.goatcounter.com/) web analytics API. It allows language models or other MCP clients to easily query Goatcounter statistics and information using a standardized tool interface.\n\nThe server is built using Python and the [FastMCP](https://github.com/metr/fastmcp) library. It reads your Goatcounter site code and API key from environment variables for authentication.\n\n## Features\n\n*   Provides tools for most Goatcounter API endpoints.\n*   Handles API key and site code configuration via environment variables (`GOATCOUNTER_API_KEY`, `GOATCOUNTER_CODE`).\n*   Lazy initialization of the API client: Tools can be listed even if API credentials are not yet configured.\n*   **Rate Limit Handling**: Implements automatic retries with backoff when encountering API rate limits (HTTP 429).\n    *   Prioritizes the `X-Rate-Limit-Reset` header for waiting if provided by the API.\n    *   Falls back to exponential backoff (starting at 1 second) with random jitter if the header is unavailable or invalid.\n    *   Retries up to 5 times before failing.\n*   Runs directly using the `fastmcp` command-line tool.\n\n## Installation\n\n### Option 1: Installing via Smithery (Recommended)\n\nTo install X (Twitter) MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/goatcounter-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @rafaljanicki/goatcounter-mcp-server --client claude\n```\n\n### Option 2: Install from PyPI\nThe easiest way to install `goatcounter-mcp-server` is via PyPI:\n\n```bash\npip install goatcounter-mcp-server\n```\n\nOr install directly from the repository:\n\n```bash\npip install git+https://github.com/rafaljanicki/goatcounter-mcp-server.git\n```\n\n### Option 3: Install fro…","publisher":null,"homepage":"https://github.com/rafaljanicki/goatcounter-mcp-server","repository":"https://github.com/rafaljanicki/goatcounter-mcp-server","version":"0.2.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:goatcounter-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"goatcounter-mcp-server","registry":"pypi","observedAt":"2026-09-15T15:24:56.561Z","publishedAt":"2025-05-14T21:48:45.635991Z","latestVersion":"0.2.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"goatcounter-mcp-server","url":"https://pypi.org/project/goatcounter-mcp-server/","firstSeenAt":"2026-09-09T16:24:14.968Z","fetchedAt":"2026-09-15T15:23:35.103Z","normalizedAt":"2026-09-15T15:23:35.103Z"}]},"firstSeenAt":"2026-09-09T16:24:14.968Z","updatedAt":"2026-09-15T15:24:56.561Z"}