https://github.com/mcpcat/mcpcat-python-sdk
MCPcat is an analytics platform for MCP server owners 🐱.
https://github.com/mcpcat/mcpcat-python-sdk
agent-runtime ai ai-agents ai-platform ai-tools analytics debugging mcp mcp-client mcp-server mcp-tools mcps observability
Last synced: 4 days ago
JSON representation
MCPcat is an analytics platform for MCP server owners 🐱.
- Host: GitHub
- URL: https://github.com/mcpcat/mcpcat-python-sdk
- Owner: MCPCat
- License: mit
- Created: 2025-05-31T00:56:13.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2025-06-17T18:19:59.000Z (10 days ago)
- Last Synced: 2025-06-17T18:50:29.007Z (10 days ago)
- Topics: agent-runtime, ai, ai-agents, ai-platform, ai-tools, analytics, debugging, mcp, mcp-client, mcp-server, mcp-tools, mcps, observability
- Language: Python
- Homepage: https://mcpcat.io
- Size: 3.01 MB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-devtools - MCPcat - User analytics, session tracking, and live debugging for MCPs (SDKs / Python)
README
Getting Started
·
Features
·
Website
·
Docs
·
Open Source
·
Discord
> [!NOTE]
> Looking for the TypeScript SDK? Check it out here [mcpcat-typescript](https://github.com/mcpcat/mcpcat-typescript-sdk).
MCPcat 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.
```bash
pip install mcpcat
```
To learn more about us, check us out [here](https://mcpcat.io)
## Why use MCPcat? 🤔
MCPcat helps developers and product owners build, improve, and monitor their MCP servers by capturing user analytics and tracing tool calls.
Use MCPcat for:
- **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.
- **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.
## Getting Started
To 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).
Once you have your project ID, integrate MCPcat into your MCP server:
```python
import mcpcat
from mcp.server import FastMCP
server = FastMCP(name="echo-mcp", version="1.0.0")
# Register tools
# NOTE: track() must be called *after* tools are setup
mcpcat.track(server, "proj_0000000")
```
### Identifying users
You can identify your user sessions with a simple callback MCPcat exposes, called `identify`.
```python
def identify_user(request, extra):
user = myapi.get_user(request.params.arguments.token)
return UserIdentity(
user_id=user.id,
user_name=user.name,
user_data={
"favorite_color": user.favorite_color,
},
)
mcpcat.track(server, "proj_0000000", MCPCatOptions(identify=identify_user))
```
### Redacting sensitive data
MCPcat 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.
```python
# Sync version
def redact_sync(text):
return custom_redact(text)
mcpcat.track(server, "proj_0000000", redact_sensitive_information=redact_sync)
```
## Free for open source
MCPcat 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.
**How to apply**: Email [email protected] with your repository link
_Already using MCPcat? We'll upgrade your account immediately._
## Community Cats 🐱
Meet the cats behind MCPcat! Add your cat to our community by submitting a PR with your cat's photo in the `docs/cats/` directory.
_Want to add your cat? Create a PR adding your cat's photo to `docs/cats/` and update this section!_