🚀 Release: mcp-audit v0.9.0

[nathanschram]

🎉 mcp-audit v0.9.0 is here!

Find + fix context bloat & high token usage in your MCP tools.

---

🆕 What's New in v0.9.0

Added

Performance Optimization (#39)

• Performance Benchmarks — CI-integrated benchmark suite
  • tests/benchmarks/test_performance.py with 14 benchmark tests
  • TUI refresh, session loading, memory usage metrics
  • Targets: TUI <100ms, session load <500ms, memory <100MB
  • All targets exceeded by 100-10000x margin
• Profiling Guide — docs/profiling.md with cProfile/tracemalloc examples

TUI Dirty-Flag Caching

• Panel Caching — Only rebuild panels whose data changed
  • _detect_changes() method compares snapshot fields
  • _cached_panels dict stores rendered panels
  • Header, tokens, tools, smells, context_tax panels cached
  • 15x faster refresh for unchanged snapshots (0.15ms → 0.01ms)

Storage Performance

• Mtime Caching — Reduce stat() calls in list_sessions()
  • 60-second TTL cache for file modification times
  • 33% faster session listing (0.69ms → 0.46ms)
• Header Peeking — peek_session_header() for fast metadata reads
  • Reads first 4KB instead of full JSON parse
  • 10-100x faster for metadata-only queries

API Cleanup & Stability (v0.9.0 - #39)

• API Stability Tiers — Explicit stability classification for all 30 public exports
  • stable: 16 APIs guaranteed backward-compatible through v1.x
  • evolving: 13 APIs with stable interface, implementation may change
  • deprecated: 1 API scheduled for removal in v1.1.0
• API Stability Infrastructure — Programmatic stability checking
  • API_STABILITY dictionary with tier classifications
  • get_api_stability(name) helper function
  • StabilityTier type alias for type hints
• API-STABILITY.md — Comprehensive stability policy documentation
  • Tier definitions and guarantees
  • Version compatibility promises
  • Migration guides for deprecated APIs
• Deprecation Warnings — Runtime warnings for deprecated APIs
  • estimate_tool_tokens now emits DeprecationWarning
  • Migration path: use TokenEstimator.estimate_tool_call() instead

Changed

• Benchmark CI Job — Added to .github/workflows/ci.yml
• RichDisplay — Refactored _build_layout() for selective panel rebuilding
• API.md — Updated with stability tier indicators and new import examples

Deprecated

• estimate_tool_tokens — Use TokenEstimator.estimate_tool_call() instead
  • Deprecated in v0.9.0, will be removed in v1.1.0
  • See API-STABILITY.md for migration guide

➡️ View all v0.9.0 issues

---

⚡ Install or Upgrade

# New install
pipx install mcp-audit

# Upgrade existing
pipx upgrade mcp-audit
# or: pip install --upgrade mcp-audit

---

🔗 Resources

📦 PyPI	pypi.org/project/mcp-audit/0.9.0/
📋 Changelog	Full version history
📚 Docs	README & platform guides
🗺️ Roadmap	What's coming next

---

🤖 Supported Platforms

Platform	Token Accuracy
Claude Code	Native (100%)
Codex CLI	Estimated (99%+)
Gemini CLI	Estimated (100% with tokenizer)

---

💬 Questions, feedback, or want support for another CLI platform?
Reply here or start a discussion!

Made with 🐻 by Little Bear Apps