How do I use mcpstat?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcpstat Show me the usage statistics for this server." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcpstat

PyPI - Version GitHub License PyPI - Python Version GitHub Actions Workflow Status PyPI - Downloads Checked with mypy Security: bandit Codecov

Usage tracking and analytics for MCP servers. Pure Python, zero required dependencies.

Track which tools get called, how often, and keep an audit trail - all in 3 lines of code.

Installation

pip install mcpstat

With MCP SDK:

pip install "mcpstat[mcp]"

Quick Start

from mcp.server import Server from mcpstat import MCPStat app = Server("my-server") stat = MCPStat("my-server") @app.call_tool() @stat.track # ← One decorator does everything! async def handle_tool(name: str, arguments: dict): # Your logic here - latency tracked automatically return await my_logic(arguments)

Then ask your AI assistant: "Give me MCP usage stats"

Features

SQLite-backed - Stats persist across restarts
Built-in MCP tools - get_tool_usage_stats, get_tool_catalog
Tag system - Categorize and filter tools
Token tracking - Estimate or record actual token usage
Latency tracking - Measure execution duration, identify slow tools
File logging - Optional timestamped audit trail
Async-first - Thread-safe via asyncio.Lock

Documentation

Full Documentation - Quick start, API reference, examples

Quick Start - Get running in 5 minutes
Configuration - Customize paths, logging, presets
API Reference - Complete method reference
Token Tracking - Cost analysis features
Latency Tracking - Performance monitoring

Examples

# Clone and run example server git clone https://github.com/tekkidev/mcpstat.git cd mcpstat pip install -e ".[mcp]" python examples/example_server.py

See examples/ for minimal and full integration patterns.

Contributing

See CONTRIBUTING.md. Run tests with:

pip install "mcpstat[dev]" pytest tests/

License

MIT - see LICENSE for details.

MCP is a trademark of its respective owners. This project is not affiliated with or endorsed by any trademark holders.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

mcpstat

mcpstat

Installation

Quick Start

Features

Documentation

Examples

Contributing

License

Resources

Latest Blog Posts

MCP directory API