{"id":28978054,"url":"https://github.com/mcpcat/mcpcat-python-sdk","last_synced_at":"2026-01-14T10:15:41.957Z","repository":{"id":299676350,"uuid":"993533458","full_name":"MCPCat/mcpcat-python-sdk","owner":"MCPCat","description":"MCPcat is an analytics platform for MCP server owners 🐱.","archived":false,"fork":false,"pushed_at":"2025-06-17T18:19:59.000Z","size":3153,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-17T18:50:29.007Z","etag":null,"topics":["agent-runtime","ai","ai-agents","ai-platform","ai-tools","analytics","debugging","mcp","mcp-client","mcp-server","mcp-tools","mcps","observability"],"latest_commit_sha":null,"homepage":"https://mcpcat.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MCPCat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T00:56:13.000Z","updated_at":"2025-06-17T18:20:02.000Z","dependencies_parsed_at":"2025-06-17T18:50:30.791Z","dependency_job_id":"9d1917dd-88ec-4f8a-85a7-8ee15efafc0d","html_url":"https://github.com/MCPCat/mcpcat-python-sdk","commit_stats":null,"previous_names":["mcpcat/mcpcat-python-sdk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MCPCat/mcpcat-python-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPCat%2Fmcpcat-python-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPCat%2Fmcpcat-python-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPCat%2Fmcpcat-python-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPCat%2Fmcpcat-python-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MCPCat","download_url":"https://codeload.github.com/MCPCat/mcpcat-python-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MCPCat%2Fmcpcat-python-sdk/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261700467,"owners_count":23196501,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-runtime","ai","ai-agents","ai-platform","ai-tools","analytics","debugging","mcp","mcp-client","mcp-server","mcp-tools","mcps","observability"],"created_at":"2025-06-24T15:02:01.306Z","updated_at":"2026-01-14T10:15:41.939Z","avatar_url":"https://github.com/MCPCat.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/static/logo-dark.svg\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"docs/static/logo-light.svg\"\u003e\n    \u003cimg alt=\"MCPcat Logo\" src=\"docs/static/logo-light.svg\" width=\"80%\"\u003e\n  \u003c/picture\u003e\n\u003c/div\u003e\n\u003ch3 align=\"center\"\u003e\n    \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n    \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"#why-use-mcpcat-\"\u003eFeatures\u003c/a\u003e\n    \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://docs.mcpcat.io\"\u003eDocs\u003c/a\u003e\n    \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://mcpcat.io\"\u003eWebsite\u003c/a\u003e\n    \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"#free-for-open-source\"\u003eOpen Source\u003c/a\u003e\n    \u003cspan\u003e · \u003c/span\u003e\n    \u003ca href=\"https://meet.mcpcat.io/meet\"\u003eSchedule a Demo\u003c/a\u003e\n\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://badge.fury.io/py/mcpcat\"\u003e\u003cimg src=\"https://badge.fury.io/py/mcpcat.svg\" alt=\"PyPI version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/mcpcat/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/dm/mcpcat.svg\" alt=\"PyPI downloads\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.10+-blue.svg\" alt=\"Python\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MCPCat/mcpcat-python-sdk/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/MCPCat/mcpcat-python-sdk.svg\" alt=\"GitHub issues\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MCPCat/mcpcat-python-sdk/actions\"\u003e\u003cimg src=\"https://github.com/MCPCat/mcpcat-python-sdk/workflows/MCP%20Version%20Compatibility%20Testing/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e [!NOTE]\n\u003e Looking for the TypeScript SDK? Check it out here [mcpcat-typescript](https://github.com/mcpcat/mcpcat-typescript-sdk).\n\nMCPcat is an analytics platform for MCP server owners 🐱. It captures user intentions and behavior patterns to help you understand what AI users actually need from your tools — eliminating guesswork and accelerating product development all with one-line of code.\n\nThis SDK also provides a free and simple way to forward telemetry like logs, traces, and errors to any Open Telemetry collector or popular tools like Datadog and Sentry. \n\n```bash\n# Basic installation (includes official MCP SDK)\npip install mcpcat\n\n# With Jlowin's/Prefect's FastMCP support\npip install \"mcpcat[community]\"\n```\n\nTo learn more about us, check us out [here](https://mcpcat.io)\n\n## Why use MCPcat? 🤔\n\nMCPcat helps developers and product owners build, improve, and monitor their MCP servers by capturing user analytics and tracing tool calls.\n\nUse MCPcat for:\n\n- **User session replay** 🎬. Follow alongside your users to understand why they're using your MCP servers, what functionality you're missing, and what clients they're coming from.\n- **Trace debugging** 🔍. See where your users are getting stuck, track and find when LLMs get confused by your API, and debug sessions across all deployments of your MCP server.\n- **Existing platform support** 📊. Get logging and tracing out of the box for your existing observability platforms (OpenTelemetry, Datadog, Sentry) — eliminating the tedious work of implementing telemetry yourself.\n\n\u003cimg width=\"1274\" height=\"770\" alt=\"mcpcat-diagram\" src=\"https://github.com/user-attachments/assets/36615b3c-7267-4b01-a055-856105c432cb\" /\u003e\n\n## Getting Started\n\nTo get started with MCPcat, first create an account and obtain your project ID by signing up at [mcpcat.io](https://mcpcat.io). For detailed setup instructions visit our [documentation](https://docs.mcpcat.io).\n\nOnce you have your project ID, integrate MCPcat into your MCP server:\n\n```python\nimport mcpcat\nfrom mcp.server import FastMCP\n\nserver = FastMCP(name=\"echo-mcp\", version=\"1.0.0\")\n\nmcpcat.track(server, \"proj_0000000\")\n```\n\n### Identifying users\n\nYou can identify your user sessions with a simple callback MCPcat exposes, called `identify`.\n\n```python\ndef identify_user(request, extra):\n    user = myapi.get_user(request.params.arguments.token)\n    return UserIdentity(\n            user_id=user.id,\n            user_name=user.name,\n            user_data={\n                \"favorite_color\": user.favorite_color,\n            },\n    )\n\nmcpcat.track(server, \"proj_0000000\", MCPCatOptions(identify=identify_user))\n```\n\n### Redacting sensitive data\n\nMCPcat redacts all data sent to its servers and encrypts at rest, but for additional security, it offers a hook to do your own redaction on all text data returned back to our servers.\n\n```python\n# Sync version\ndef redact_sync(text):\n    return custom_redact(text)\n\nmcpcat.track(server, \"proj_0000000\", redact_sensitive_information=redact_sync)\n```\n\n### Forwarding data to existing observability platforms\n\nMCPcat seamlessly integrates with your existing observability stack, providing automatic logging and tracing without the tedious setup typically required. Export telemetry data to multiple platforms simultaneously:\n\n```python\nfrom mcpcat import MCPCatOptions, ExporterConfig\n\nmcpcat.track(\n    server, \n    \"proj_0000000\", # Or None if you just want to use the SDK to forward telemetry\n    MCPCatOptions(\n        exporters={\n            # OpenTelemetry - works with Jaeger, Tempo, New Relic, etc.\n            \"otlp\": ExporterConfig(\n                type=\"otlp\",\n                endpoint=\"http://localhost:4318/v1/traces\"\n            ),\n            # Datadog\n            \"datadog\": ExporterConfig(\n                type=\"datadog\",\n                api_key=os.getenv(\"DD_API_KEY\"),\n                site=\"datadoghq.com\",\n                service=\"my-mcp-server\"\n            ),\n            # Sentry\n            \"sentry\": ExporterConfig(\n                type=\"sentry\",\n                dsn=os.getenv(\"SENTRY_DSN\"),\n                environment=\"production\"\n            )\n        }\n    )\n)\n```\n\nLearn more about our free and open source [telemetry integrations](https://docs.mcpcat.io/telemetry/integrations).\n\n## Free for open source\n\nMCPcat is free for qualified open source projects. We believe in supporting the ecosystem that makes MCP possible. If you maintain an open source MCP server, you can access our full analytics platform at no cost.\n\n**How to apply**: Email hi@mcpcat.io with your repository link\n\n_Already using MCPcat? We'll upgrade your account immediately._\n\n## Community Cats 🐱\n\nMeet the cats behind MCPcat! Add your cat to our community by submitting a PR with your cat's photo in the `docs/cats/` directory.\n\n\u003cdiv align=\"left\"\u003e\n  \u003cimg src=\"docs/cats/bibi.png\" alt=\"bibi\" width=\"80\" height=\"80\"\u003e\n  \u003cimg src=\"docs/cats/zelda.jpg\" alt=\"zelda\" width=\"80\" height=\"80\"\u003e\n\u003c/div\u003e\n\n_Want to add your cat? Create a PR adding your cat's photo to `docs/cats/` and update this section!_\n","funding_links":[],"categories":["SDKs"],"sub_categories":["Python"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcpcat%2Fmcpcat-python-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcpcat%2Fmcpcat-python-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcpcat%2Fmcpcat-python-sdk/lists"}