{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6vachykav52y","handle":"mcp-observer","url":"https://wellknown.network/agents/mcp-observer","links":{"self":"https://wellknown.network/agents/mcp-observer/record.json","html":"https://wellknown.network/agents/mcp-observer","markdown":"https://wellknown.network/agents/mcp-observer/record.md","api":"https://wellknown.network/api/v1/agents/mcp-observer","status":"https://wellknown.network/api/v1/agents/mcp-observer/status","claim":"https://wellknown.network/agents/mcp-observer/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-observer/claim.json","badge":"https://wellknown.network/agents/mcp-observer/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-observer/history","tools":"https://wellknown.network/api/v1/agents/mcp-observer/tools"},"ard":{"identifier":"urn:air::server:mcp-observer","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-observer","summary":"A decorator-based observability SDK for MCP (Model Context Protocol) tools with OpenTelemetry integration","description":"# MCP Observer SDK\n\n[![PyPI version](https://badge.fury.io/py/mcp-observer.svg)](https://badge.fury.io/py/mcp-observer)\n[![Python Versions](https://img.shields.io/pypi/pyversions/mcp-observer.svg)](https://pypi.org/project/mcp-observer/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA lightweight, decorator-based observability SDK for [Model Context Protocol (MCP)](https://modelcontextprotocol.io) tools. Add comprehensive telemetry and insights to your MCP servers with a single line of code.\n\n## Features\n\n- **Zero-friction Integration**: Add observability with a simple decorator\n- **OpenTelemetry Support**: Built-in tracing, metrics, and distributed context propagation\n- **Privacy-First**: Configurable I/O tracking with dual-consent system\n- **Universal Compatibility**: Works with all MCP tool function signatures\n- **Dual Storage**: Durable storage for analytics + real-time streaming via OpenTelemetry\n- **Session Tracking**: Automatic session and request correlation\n\n## Installation\n\n### From PyPI\n\n```bash\npip install mcp-observer\n```\n\n### Using uv (recommended)\n\n```bash\nuv pip install mcp-observer\n```\n\n### For development\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/mcp-observer-sdk.git\ncd mcp-observer-sdk\n\n# Install in development mode\npip install -e \".[dev]\"\n```\n\n## Quick Start\n\n```python\nfrom mcp_observer import MCPObserver\nfrom fastmcp import FastMCP\n\n# Initialize your MCP server\nmcp = FastMCP(\"MyServer\")\n\n# Initialize the observer (project is automatically determined from your API key)\nobserver = MCPObserver(\n    name=\"MyServer\",\n    version=\"1.0.0\",\n    api_key=\"your-generated-api-key\"\n)\n\n# Decorate your tools\n@mcp.tool()\n@observer.track(track_io=True)\nasync def my_tool(data: dict) -> dict:\n    # Your tool logic here\n    return {\"result\": \"success\"}\n```\n\n## Examples\n\n### Example 1: Simple Tool (No Context)\n\n```python\nfrom mcp_observer import MCPObserver\nfrom fastmcp i…","publisher":null,"homepage":"https://github.com/yourusername/mcp-observer-sdk#readme","repository":"https://github.com/yourusername/mcp-observer-sdk/issues","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","observability","telemetry","opentelemetry","tracing","monitoring","fastmcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-observer","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.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"}],"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":"mcp-observer","registry":"pypi","observedAt":"2026-11-03T14:24:03.203Z","publishedAt":"2025-12-17T16:37:11.262058Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-observer","url":"https://pypi.org/project/mcp-observer/","firstSeenAt":"2026-09-10T02:24:19.175Z","fetchedAt":"2026-11-03T14:22:55.034Z","normalizedAt":"2026-11-03T14:22:55.034Z"}]},"firstSeenAt":"2026-09-10T02:24:19.175Z","updatedAt":"2026-11-03T14:24:03.203Z"}