{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xjb2m3pthq9f","handle":"ariel-san-martin-mcp-supervisor","url":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor","links":{"self":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor/record.json","html":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor","markdown":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor/record.md","api":"https://wellknown.network/api/v1/agents/ariel-san-martin-mcp-supervisor","status":"https://wellknown.network/api/v1/agents/ariel-san-martin-mcp-supervisor/status","claim":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor/claim.json","badge":"https://wellknown.network/agents/ariel-san-martin-mcp-supervisor/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/ariel-san-martin-mcp-supervisor/history","tools":"https://wellknown.network/api/v1/agents/ariel-san-martin-mcp-supervisor/tools"},"ard":{"identifier":"urn:air::server:ariel-san-martin-mcp-supervisor","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-supervisor","summary":"MCP server exposing runtime-supervisor tools to LLM agents (Claude Desktop, Cursor, etc.)","description":"# mcp-supervisor\n\nMCP server that exposes runtime-supervisor as tools for LLM agents (Claude Desktop, Claude Code, any MCP-aware client).\n\n## Install\n\n```bash\nuv pip install -e packages/mcp-supervisor\n# or from PyPI once published:\npip install mcp-supervisor\n```\n\n## Configure\n\nEnvironment variables:\n\n| Variable              | Required | Description                                            |\n| --------------------- | -------- | ------------------------------------------------------ |\n| `SUPERVISOR_URL`      | yes      | Supervisor API base URL (e.g. `http://localhost:8000`) |\n| `SUPERVISOR_APP_ID`   | yes      | Integration id issued by `POST /v1/integrations`       |\n| `SUPERVISOR_SECRET`   | yes      | Shared secret returned at registration                 |\n| `SUPERVISOR_SCOPES`   | no       | Comma-separated scopes (default `*`)                   |\n\n## Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"runtime-supervisor\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"/path/to/agentic-internal-controls\", \"run\", \"mcp-supervisor\"],\n      \"env\": {\n        \"SUPERVISOR_URL\": \"http://localhost:8000\",\n        \"SUPERVISOR_APP_ID\": \"your-integration-id\",\n        \"SUPERVISOR_SECRET\": \"your-shared-secret\",\n        \"SUPERVISOR_SCOPES\": \"refund,payment\"\n      }\n    }\n  }\n}\n```\n\n## Exposed tools\n\n- `evaluate_action(action_type, payload, dry_run=false)` — gate an agent action through policy + risk.\n- `list_action_types()` — discover what's supervised (live vs planned).\n- `get_evidence(action_id)` — fetch the hash-chained evidence bundle for audit.\n\n## Example prompt to Claude\n\n> \"Before I execute a $1200 refund for a customer who signed up 18 days ago and has had 2 refunds in the last 24h, use `evaluate_action` with dry_run=true to show me what the supervisor would decide.\"","publisher":{"name":"Ariel San Martín","url":null},"homepage":"https://github.com/ArielSanroj/runtime-supervisor","repository":"https://github.com/ArielSanroj/runtime-supervisor","version":"0.3.0","license":null,"protocols":["mcp"],"tags":["ai-agents","claude","guardrails","mcp","runtime-supervisor"],"pricing":null,"endpoints":[{"url":"pypi:mcp-supervisor","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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"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-supervisor","registry":"pypi","observedAt":"2026-11-09T18:26:20.827Z","publishedAt":"2026-04-25T20:51:03.842315Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-supervisor","url":"https://pypi.org/project/mcp-supervisor/","firstSeenAt":"2026-09-10T04:23:30.917Z","fetchedAt":"2026-11-09T18:25:25.890Z","normalizedAt":"2026-11-09T18:25:25.890Z"}]},"firstSeenAt":"2026-09-10T04:23:30.917Z","updatedAt":"2026-11-09T18:26:20.827Z"}