From a9d2967cfc1e481514f898e4e67719d92b87a263 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 9 Nov 2026 21:18:23 +0000 Subject: [PATCH 1/3] docs: add plain-language summary and availability line to README Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01S6z9ir4UmGWhKHFHrtr8Ux --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 4f4a385..d9c2c36 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,10 @@ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](pyproject.toml) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) +In plain terms: a Python library that adds login checks, caching and logging to the tools AI assistants call. + +**Built by [Cayman Roden](https://github.com/ChunkyTortoise)**, AI engineer in Los Angeles. Available now for contract, part-time or full-time work, US remote. [Portfolio](https://chunkytortoise.github.io) · [LinkedIn](https://linkedin.com/in/caymanroden) + Every MCP server that touches real data needs the same guard code around each tool: verify the caller's token, check its scope, refuse writes to the database, cache repeat calls and trace what ran. This Python library puts that code in decorators on top of the MCP SDK's `MCPServer` (FastMCP in mcp 1.x), with JWT/JWKS auth, a sqlglot read-only SQL allowlist, a TTL cache and OpenTelemetry spans, so a tool stays a plain async function. Each guard is opt-in per tool. ```python From 330c9ac5515c1d4f1c9a5f8c900365ecc448b705 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 9 Nov 2026 21:32:51 +0000 Subject: [PATCH 2/3] docs: drop roadmap item that already shipped (RedisSlidingWindow) Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01S6z9ir4UmGWhKHFHrtr8Ux --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index d9c2c36..ae39e5f 100644 --- a/README.md +++ b/README.md @@ -218,7 +218,6 @@ INTEGRATION=1 REDIS_URL=redis://localhost:6379 pytest tests/test_framework/test_ There are no open issues; these are the next steps documented in the repository. -- Ship the opt-in Redis backend for the rate limiter described in [ADR-0005](docs/adr/ADR-0005-rate-limit-distribution.md). - Deploy the observability stack from its committed [Render blueprint](examples/observability/render.yaml) and verify OTLP export end to end with [`verify_otlp.py`](examples/observability/verify_otlp.py) ([steps](examples/observability/README.md#verify-an-otlp-deployment)). - Measure a real RAG workload end to end and publish a dated run artifact alongside the [case study](docs/CASE_STUDY.md). From 733134610934d5f0ca3bafddf85c5afdf379e138 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 9 Nov 2026 21:51:37 +0000 Subject: [PATCH 3/3] docs: tighten README wording after outside review Narrow claims to what the repo demonstrates. Co-Authored-By: Claude Fable 5.2 Claude-Session: https://claude.ai/code/session_01S6z9ir4UmGWhKHFHrtr8Ux --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ae39e5f..aded809 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,11 @@ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](pyproject.toml) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) -In plain terms: a Python library that adds login checks, caching and logging to the tools AI assistants call. +In plain terms: a Python library for adding token and scope checks, caching, rate limits and tracing to MCP tools used by AI assistants. **Built by [Cayman Roden](https://github.com/ChunkyTortoise)**, AI engineer in Los Angeles. Available now for contract, part-time or full-time work, US remote. [Portfolio](https://chunkytortoise.github.io) · [LinkedIn](https://linkedin.com/in/caymanroden) -Every MCP server that touches real data needs the same guard code around each tool: verify the caller's token, check its scope, refuse writes to the database, cache repeat calls and trace what ran. This Python library puts that code in decorators on top of the MCP SDK's `MCPServer` (FastMCP in mcp 1.x), with JWT/JWKS auth, a sqlglot read-only SQL allowlist, a TTL cache and OpenTelemetry spans, so a tool stays a plain async function. Each guard is opt-in per tool. +MCP tools that touch real data often need the same guard code: verify the caller's token, check its scope, cache repeat calls, limit request rates and trace what ran. The included database server also refuses writes with read-only SQL checks. This Python library puts that code in decorators on top of the MCP SDK's `MCPServer` (FastMCP in mcp 1.x), with JWT/JWKS auth, a sqlglot read-only SQL allowlist, a TTL cache and OpenTelemetry spans, so a tool stays a plain async function. Each guard is opt-in per tool. ```python import asyncio, jwt