{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yzkce73mcfef","handle":"mcp-observability","url":"https://wellknown.network/agents/mcp-observability","links":{"self":"https://wellknown.network/agents/mcp-observability/record.json","html":"https://wellknown.network/agents/mcp-observability","markdown":"https://wellknown.network/agents/mcp-observability/record.md","api":"https://wellknown.network/api/v1/agents/mcp-observability","status":"https://wellknown.network/api/v1/agents/mcp-observability/status","claim":"https://wellknown.network/agents/mcp-observability/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-observability/claim.json","badge":"https://wellknown.network/agents/mcp-observability/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-observability/history","tools":"https://wellknown.network/api/v1/agents/mcp-observability/tools"},"ard":{"identifier":"urn:air::server:mcp-observability","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-observability","summary":"Open, vendor-agnostic observability SDK for Model Context Protocol (MCP) applications","description":"# MCP Observability SDK for Python\n\nOpen, vendor-agnostic observability SDK for Model Context Protocol (MCP) applications. No vendor lock-in, plug-and-play integration, and extensible for rate limiting, tool filtering, auth, and traceability.\n\n## Installation\n\n```bash\npip install mcp-hack\n```\n\n## Quick Start\n\n### 1. Get an API Key\n\n1. Visit [https://etalesystems.com](https://etalesystems.com)\n2. Sign in with your Google account\n3. Create a new API key from the dashboard\n4. Set your API key as an environment variable:\n\n```bash\nexport MCP_API_KEY=\"your_api_key_here\"\n```\n\n### 2. Use in Your Code\n\n```python\nimport os\nfrom mcp_observability import MCPObservability\n\n# Initialize observability\nobs = MCPObservability(\n    api_url=\"https://etalesystems.com/api\",  # Production backend URL\n    api_key=os.getenv('MCP_API_KEY')  # Your API key from etalesystems.com\n)\n\n# Add observability to your MCP tools\n@mcp.tool()\n@obs.tool_observer(\"add_numbers\")\ndef add(a: int, b: int) -> int:\n    \"\"\"Add two numbers\"\"\"\n    return a + b\n\n# Get metrics\nmetrics = obs.get_metrics()\nprint(f\"Total calls: {metrics['summary']['total_calls']}\")\n```\n\n## Features\n\n- 🔍 **Automatic Tool Tracing**: Monitor all MCP tool calls with zero configuration\n- 📊 **Rich Metrics**: Execution time, success rates, error tracking\n- 🚀 **Non-blocking**: Async trace submission doesn't slow down your tools\n- 🔒 **Secure**: API key authentication with environment variable support\n- 📈 **Dashboard Integration**: Real-time visualization of your MCP tools\n\n## API Reference\n\n### MCPObservability\n\nMain class for MCP observability.\n\n#### Constructor\n\n```python\nMCPObservability(api_url: str, api_key: Optional[str] = None)\n```\n\n- `api_url`: URL of your observability backend\n- `api_key`: API key for authentication (optional, but required for trace submission)\n\n#### Methods\n\n##### tool_observer(tool_name: Optional[str] = None)\n\nDecorator to add observability to MCP tools.\n\n```python\n@obs.tool_observer(\"my_tool\")\ndef my_tool(param…","publisher":null,"homepage":"https://github.com/anish808/mcp-hack#readme","repository":"https://github.com/anish808/mcp-hack/issues","version":"0.1.2","license":null,"protocols":["mcp"],"tags":["ai","llm","mcp","monitoring","observability","tracing"],"pricing":null,"endpoints":[{"url":"pypi:mcp-observability","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.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"},{"slug":"analytics.reporting","name":"Reporting & Dashboards","confidence":0.882,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["analytics","dev","security"],"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-observability","registry":"pypi","observedAt":"2026-10-28T12:22:56.162Z","publishedAt":"2025-06-24T22:03:40.325007Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-observability","url":"https://pypi.org/project/mcp-observability/","firstSeenAt":"2026-09-10T02:24:18.095Z","fetchedAt":"2026-10-28T12:21:27.458Z","normalizedAt":"2026-10-28T12:21:27.458Z"}]},"firstSeenAt":"2026-09-10T02:24:18.095Z","updatedAt":"2026-10-28T12:22:56.162Z"}