{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cwc7kkjr6ksp","handle":"observatory-mcp","url":"https://wellknown.network/agents/observatory-mcp","links":{"self":"https://wellknown.network/agents/observatory-mcp/record.json","html":"https://wellknown.network/agents/observatory-mcp","markdown":"https://wellknown.network/agents/observatory-mcp/record.md","api":"https://wellknown.network/api/v1/agents/observatory-mcp","status":"https://wellknown.network/api/v1/agents/observatory-mcp/status","claim":"https://wellknown.network/agents/observatory-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/observatory-mcp/claim.json","badge":"https://wellknown.network/agents/observatory-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/observatory-mcp/history","tools":"https://wellknown.network/api/v1/agents/observatory-mcp/tools"},"ard":{"identifier":"urn:air::server:observatory-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"observatory-mcp","summary":"Observatory SDK for MCP server analytics and monitoring - Add comprehensive observability to your MCP servers with just 2 lines of code","description":"# Observatory MCP Python SDK\n\n[![PyPI version](https://badge.fury.io/py/observatory-mcp.svg)](https://badge.fury.io/py/observatory-mcp)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**Add comprehensive analytics and monitoring to your MCP servers with just 2-3 lines of code.**\n\nObservatory SDK provides lightweight, zero-configuration observability for Model Context Protocol (MCP) servers. Track performance metrics, protocol messages, errors, and user behavior without modifying your existing MCP server implementation.\n\n## ✨ Features\n\n- 🚀 **2-Line Integration**: Add observability with minimal code changes\n- 📊 **Complete Analytics**: Protocol messages, performance metrics, error tracking\n- 🔒 **Privacy-First**: Built-in PII detection and data masking\n- ⚡ **Lightweight**: <1ms overhead per message, async processing\n- 🎯 **Smart Sampling**: Adaptive sampling with error prioritization\n- 🔌 **Zero Server Modification**: Works via protocol message interception\n- 📈 **Real-Time Monitoring**: Live dashboards and alerting\n- 🐍 **Type-Safe**: Full type hints for IDE autocomplete\n\n## 📦 Installation\n\n```bash\npip install observatory-mcp\n```\n\nFor MCP server integration:\n```bash\npip install observatory-mcp[mcp]\n```\n\nFor development:\n```bash\npip install observatory-mcp[dev]\n```\n\n## 🚀 Quick Start\n\n### Basic Integration (2 lines!)\n\n```python\nfrom mcp.server import Server\nfrom observatory_mcp import ObservatorySDK\n\n# Create your MCP server as usual\napp = Server(\"my-awesome-mcp-server\")\n\n# Add Observatory with 2 lines!\nobservatory = ObservatorySDK(\n    api_key=\"obs_live_xyz123\",\n    server_name=\"my-awesome-mcp-server\",\n    server_version=\"1.0.0\"\n)\napp = observatory.wrap_server(app)\n\n# Your handlers work exactly the same - Observatory tracks automatically!\n@app.list_tools()\nasync def list_tools():\n    return [...]\n\n@ap…","publisher":null,"homepage":"https://observatory.dev/docs/python-sdk","repository":"https://github.com/observatory/observatory/blob/main/CHANGELOG.md","version":"0.0.2.dev0","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","observability","analytics","monitoring","telemetry","metrics","tracking","sdk"],"pricing":null,"endpoints":[{"url":"pypi:observatory-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"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":"observatory-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:35.541Z","publishedAt":"2025-10-09T04:53:12.059048Z","latestVersion":"0.0.2.dev0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"observatory-mcp","url":"https://pypi.org/project/observatory-mcp/","firstSeenAt":"2026-09-10T08:25:53.641Z","fetchedAt":"2026-11-03T20:28:09.040Z","normalizedAt":"2026-11-03T20:28:09.040Z"}]},"firstSeenAt":"2026-09-10T08:25:53.641Z","updatedAt":"2026-11-03T20:29:35.541Z"}