{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_27wussxn4jfq","handle":"mcp-warden","url":"https://wellknown.network/agents/mcp-warden","links":{"self":"https://wellknown.network/agents/mcp-warden/record.json","html":"https://wellknown.network/agents/mcp-warden","markdown":"https://wellknown.network/agents/mcp-warden/record.md","api":"https://wellknown.network/api/v1/agents/mcp-warden","status":"https://wellknown.network/api/v1/agents/mcp-warden/status","claim":"https://wellknown.network/agents/mcp-warden/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-warden/claim.json","badge":"https://wellknown.network/agents/mcp-warden/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-warden/history","tools":"https://wellknown.network/api/v1/agents/mcp-warden/tools"},"ard":{"identifier":"urn:air::server:mcp-warden","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-warden","summary":"MCP observability and control plane — audit logging, rate limiting, circuit breaker for any MCP server","description":"# 👁️ mcp-warden\n\n**MCP observability and control plane.**\n\n```bash\npip install mcp-warden\n\nmcp-warden audit -- your-mcp-server [args...]\nmcp-warden guard --max-calls-per-minute 30 --block-tool write_query -- any-mcp-server\nmcp-warden both  --max-calls-per-minute 60 --max-response-kb 512 -- any-mcp-server\nmcp-warden log   --tail 20\n```\n\n[![PyPI version](https://img.shields.io/pypi/v/mcp-warden.svg)](https://pypi.org/project/mcp-warden/)\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![CI](https://github.com/raj8github/mcp-warden/actions/workflows/ci.yml/badge.svg)](https://github.com/raj8github/mcp-warden/actions)\n[![Zero dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg)]()\n\n---\n\n## The problem\n\nMCP clients like Cline and Claude Desktop can call tools on any connected server with no visibility and no throttle.\n\nAn agent in a loop can:\n- Call `sql_query` hundreds of times a minute, burning your API budget\n- Pull back 50 MB of data in a single tool call\n- Hit a tool you meant to leave off\n- Fail repeatedly and nobody notices until the damage is done\n\nmcp-warden fixes all of this — for **any** MCP server, without touching it.\n\n---\n\n## How it works\n\n```\nMCP client (Cline / Claude Desktop)\n    │  stdin/stdout\n    ▼\nmcp-warden  ◄──── audit + guard\n    │  subprocess stdin/stdout\n    ▼\nUpstream MCP server (any MCP server)\n```\n\nmcp-warden is a transparent JSON-RPC relay. The client never knows it's there. The upstream server never knows it's there. Every `tools/call` passes through the audit and guard layer in the middle.\n\n**Latency impact:** ~0.1–0.5 ms per message — negligible against typical LLM tool call round trips of 100 ms to 10 s.\n\n---\n\n## Install\n\n```bash\npip install mcp-warden\n```\n\nZero runtime dependencies. Pure Python 3.9+ stdlib.\n\n---\n\n## Usage\n\n### Audit — log everything\n\n```bash\nmcp-warden audit \\\n  --audit-…","publisher":{"name":"Raj Shashi","url":null},"homepage":"https://github.com/raj8github/mcp-warden","repository":"https://github.com/raj8github/mcp-warden/releases","version":"0.1.3","license":"MIT License\n        \n        Copyright (c) 2025 Raj Shashi\n    …","protocols":["mcp"],"tags":["agent","ai","audit","claude","guardrail","llm","mcp","observability","proxy","rate-limit"],"pricing":null,"endpoints":[{"url":"pypi:mcp-warden","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.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.733,"provenance":"derived"}],"categories":["data","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-warden","registry":"pypi","observedAt":"2026-11-03T17:25:57.732Z","publishedAt":"2026-03-07T11:09:50.717958Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-warden","url":"https://pypi.org/project/mcp-warden/","firstSeenAt":"2026-09-10T05:21:54.256Z","fetchedAt":"2026-11-03T17:24:16.956Z","normalizedAt":"2026-11-03T17:24:16.956Z"}]},"firstSeenAt":"2026-09-10T05:21:54.256Z","updatedAt":"2026-11-03T17:25:57.732Z"}