{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4pkd3c886f6y","handle":"mcp-monitor-local-sdk","url":"https://wellknown.network/agents/mcp-monitor-local-sdk","links":{"self":"https://wellknown.network/agents/mcp-monitor-local-sdk/record.json","html":"https://wellknown.network/agents/mcp-monitor-local-sdk","markdown":"https://wellknown.network/agents/mcp-monitor-local-sdk/record.md","api":"https://wellknown.network/api/v1/agents/mcp-monitor-local-sdk","status":"https://wellknown.network/api/v1/agents/mcp-monitor-local-sdk/status","claim":"https://wellknown.network/agents/mcp-monitor-local-sdk/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-monitor-local-sdk/claim.json","badge":"https://wellknown.network/agents/mcp-monitor-local-sdk/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-monitor-local-sdk/history","tools":"https://wellknown.network/api/v1/agents/mcp-monitor-local-sdk/tools"},"ard":{"identifier":"urn:air::server:mcp-monitor-local-sdk","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-monitor-local-sdk","summary":"Self-host monitoring SDK for Python MCP servers","description":"# mcp-monitor-local-sdk\n\nSelf-host monitoring SDK for Python MCP servers. [User guide](#user-guide) · [Developer guide](#developer-guide)\n\nRepo copies: [USER.md](USER.md) · [DEV.md](DEV.md)\n\n## User guide\n\nPoint this SDK at your self-host API (`metrics_server_url` + `instance_secret`). It wraps tool handlers and sends tool-call metrics (name, duration, success/error) — not application logs — to `POST /v1/metrics`. Open the local UI or desktop app to see them. This package does not talk to the hosted dashboard.\n\n```bash\npip install mcp-monitor-local-sdk\n```\n\n```python\nfrom mcp_monitor_sdk import MonitoredFastMCP\n\nserver = MonitoredFastMCP(\n    \"todo-mcp\",\n    server_name=\"todo-mcp\",\n    instance_secret=\"change-me-to-a-long-random-secret\",\n    metrics_server_url=\"http://localhost:8000/v1/metrics\",\n)\n\n@server.tool()\ndef todos_list() -> str:\n    \"\"\"List all todos.\"\"\"\n    return \"No todos.\"\n\nif __name__ == \"__main__\":\n    server.run()\n```\n\n`instance_secret` must match `INSTANCE_SECRET` on the API.\n\n## Developer guide\n\nSame ingest contract as the JS SDK. Built to sit next to the official [`mcp`](https://pypi.org/project/mcp/) package.\n\n### Options\n\n| Option | Required | Default | Notes |\n|---|---|---|---|\n| `server_name` | yes | | Trimmed and lowercased |\n| `instance_secret` | yes | | Min 16 characters; sent as `X-Instance-Secret` |\n| `metrics_server_url` | yes | | Full ingest URL, usually `http://localhost:8000/v1/metrics` |\n| `batch_size` | no | 10 | Max 100 |\n| `retry_attempts` | no | 2 | `0` still tries once |\n| `timeout_ms` | no | 5000 | |\n| `flush_interval_ms` | no | 5000 | |\n| `log_level` | no | `info` | `debug` \\| `info` \\| `warn` \\| `error` \\| `silent` |\n\nEvents flush when the batch is full or every `flush_interval_ms`. Failed flushes are restored. Shutdown drains remaining events.\n\nLocal checkout:\n\n```bash\npip install -e ./local/sdk/py\n```\n\nPublish:\n\n```bash\ncd local/sdk/py\npython -m build\ntwine upload dist/*\n```","publisher":{"name":"MCP Monitor","url":null},"homepage":"https://pypi.org/project/mcp-monitor-local-sdk/","repository":"https://pypi.org/project/mcp/","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["mcp","metrics","model-context-protocol","observability"],"pricing":null,"endpoints":[{"url":"pypi:mcp-monitor-local-sdk","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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":0.745,"provenance":"derived"}],"categories":["dev","productivity"],"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-monitor-local-sdk","registry":"pypi","observedAt":"2026-11-09T16:26:05.242Z","publishedAt":"2026-09-14T11:56:40.120213Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-monitor-local-sdk","url":"https://pypi.org/project/mcp-monitor-local-sdk/","firstSeenAt":"2026-09-16T01:20:28.028Z","fetchedAt":"2026-11-09T16:24:42.763Z","normalizedAt":"2026-11-09T16:24:42.763Z"}]},"firstSeenAt":"2026-09-16T01:20:28.028Z","updatedAt":"2026-11-09T16:26:05.242Z"}