INDEX.md

tapps-mcp — Documentation Index

138 documents across 9 categories

Overview

Category	Count
API Reference	32
Architecture	46
Configuration	3
Getting Started	15
Guides	9
Operations	6
Other	5
Planning	12
Release	10

API Reference

• Configuration Reference — TappsMCP is configured via .tapps-mcp.yaml in the project root. Settings can also be overridden with environment va... (updated 2026-06-22)
• Field Report: TappsMCP + DocsMCP Full-Session Usage — Date: 2026-04-06 (updated 2026-04-06)
• tapps-mcp — Documentation Index — 138 documents across 9 categories (updated 2026-06-22)
• TappsMCP Memory Reference — Complete reference for TappsMCP shared brain memory — 44 actions when accessed via CLI or the nlt-memory MC... (updated 2026-06-16)
• Skill Authoring Conventions — Reference commit: mattpocock/skills@b8be62f (updated 2026-05-27)
• TAP-967: 2-Week list_issues Call-Count Measurement Report — Measurement date: 2026-05-07 (updated 2026-06-13)
• packages.docs-mcp.src.docs_mcp — Docs MCP: Documentation MCP server for the Tapps platform. (updated 2026-06-22)
• API Reference Index — Auto-generated package-level API docs (public symbols, markdown). Regenerate with docs_generate_api per package or ... (updated 2026-06-22)
• packages.tapps-core.src.tapps_core — Tapps Core: Shared infrastructure library for the Tapps platform. (updated 2026-06-22)
• packages.tapps-mcp.src.tapps_mcp — TappsMCP: MCP server providing code quality tools. (updated 2026-06-22)
• packages.docs-mcp.src.docs_mcp — Docs MCP: Documentation MCP server for the Tapps platform. (updated 2026-04-05)
• packages.tapps-core.src.tapps_core — Tapps Core: Shared infrastructure library for the Tapps platform. (updated 2026-04-05)
• packages.tapps-mcp.src.tapps_mcp.server_analysis_tools — Analysis and inspection tool handlers for TappsMCP. (updated 2026-04-05)
• packages.tapps-mcp.src.tapps_mcp.server — TappsMCP MCP server entry point. (updated 2026-04-05)
• packages.tapps-mcp.src.tapps_mcp.server_expert_tools — Business expert management tool handlers for TappsMCP. (updated 2026-04-05)
• packages.tapps-mcp.src.tapps_mcp.server_memory_tools — Memory tool handlers for TappsMCP. (updated 2026-04-05)
• packages.tapps-mcp.src.tapps_mcp.server_metrics_tools — Metrics, dashboard, feedback, and research tool handlers for TappsMCP. (updated 2026-04-05)
• packages.tapps-mcp.src.tapps_mcp.server_pipeline_tools — Pipeline orchestration and validation tool handlers for TappsMCP. (updated 2026-06-09)
• packages.tapps-mcp.src.tapps_mcp.server_scoring_tools — Scoring and quality-gate tool handlers for TappsMCP. (updated 2026-04-05)
• 2026 Claude Control Files Audit & Grading Report — Project: TappsMCP (updated 2026-04-05)
• TappsPlatform Composition Guide — TappsMCP (29 code quality tools) and DocsMCP (19 documentation tools) can be served as a single combined MCP server —... (updated 2026-04-05)
• MCP Context (ctx) Pattern Reference — This document defines TappsMCP's standard patterns for using the MCP Context object (updated 2026-04-05)
• MCP Client Timeouts and Long-Running Tools — TappsMCP exposes several tools that can take 10–35+ seconds to complete. Some MCP clients (e.g. Cursor, Claude Code) ... (updated 2026-04-05)
• MCP Composition and Rule Hierarchy — TappMCP works as one MCP server in a larger AI-assistant setup. This doc explains how to compose it with other MCPs a... (updated 2026-04-05)
• Migration from tapps-agents to TappsMCP — If you were using tapps-agents (e.g. .tapps-agents/, experts config, knowledge files) and are moving to **Tapps... (updated 2026-04-05)
• Module Map — Total modules: 316 (updated 2026-04-05)
• TappsMCP Consumer Requirements — This is the canonical checklist of what a consuming project needs for TappsMCP tools to work. Use it to verify your s... (updated 2026-04-05)
• tapps_validate_changed: Loop and Timing Review — The text "Before ending: please run tapps_validate_changed to confirm all changed files pass quality gates." is p... (updated 2026-04-05)
• Addenda — Best Practices for Using TappsMCP — This document supplements the main README.md and AGENTS.md with best practices, tips, and guidance for getting the mo... (updated 2026-04-05)
• CI Integration Guide — TappsMCP can run quality checks in CI pipelines without an interactive session. (updated 2026-04-05)
• Phase B Rollup — outputSchema declarations on high-traffic tools — Status: CLOSED — B1 shipped as a low-risk schema declaration, B4–B8 (updated 2026-05-22)
• Operator secrets (one file, all repos) — TappsMCP operator secrets are machine-wide — the same Context7 API key and (updated 2026-06-15)

Architecture

• TappsMCP Architecture Reference — Detailed internal architecture for developers working on TappsMCP itself. (updated 2026-06-22)
• tapps-mcp — Architecture Overview — tapps-mcp exists to give AI coding assistants deterministic, checker-backed quality tools instead of relying ... (updated 2026-06-22)
• 1. In-process AgentBrain via BrainBridge — Date: 2026-05-02 (updated 2026-05-12)
• 2. Pin tapps-brain version floor at 3.7.2 (range: >=3.7.2, <4) — Date: 2026-05-02 (updated 2026-05-15)
• 4. Deterministic-tools-only contract — Date: 2026-05-02 (updated 2026-05-12)
• 5. MCP server zombie-cleanup hook on session start — Date: 2026-05-02 (updated 2026-06-16)
• 6. tapps_validate_changed requires explicit file_paths — Date: 2026-05-02 (updated 2026-05-12)
• 7. Linear writes default assignee to the agent, never the OAuth human — Date: 2026-05-02 (updated 2026-05-12)
• 8. Delete SQLite MemoryPersistence edge-case tests — Status: Accepted (updated 2026-05-12)
• 9. Pin tapps-brain version floor at 3.17.0 (range: >=3.17.0, <4) — Date: 2026-05-15 (updated 2026-05-16)
• 10. Pin tapps-brain version floor at 3.18.0 (range: >=3.18.0, <4) — Date: 2026-05-16 (updated 2026-05-18)
• 11. Pin tapps-brain by release tag instead of commit SHA — Date: 2026-05-18 (updated 2026-05-18)
• 12. Select the tapps-brain capability profile per consumer role — Date: 2026-06-03 (updated 2026-06-03)
• 13. Pin tapps-brain version floor at 3.24.0 (range: >=3.24.0, <4) — Date: 2026-06-09 (updated 2026-06-14)
• 14. Brain-central doc RAG (big-bang cutover) — Date: 2026-06-13 (updated 2026-06-14)
• 15. Require tapps-brain docs_lookup at 3.24.0+ (ADR-0014 consumer floor) — Date: 2026-06-13 (updated 2026-06-13)
• 16. Needs-based NLT MCP taxonomy (Build / Memory / Setup) — Date: 2026-06-13 (updated 2026-06-22)
• 17. Function-level call graph (Python-first) — Date: 2026-06-15 (updated 2026-06-15)
• 18. Deploy all six NLT MCP servers by default (full bundle) — Date: 2026-06-16 (updated 2026-06-16)
• 19. Blue/green dev-monorepo MCP deploy — Date: 2026-06-16 (updated 2026-06-16)
• 20. Global uv-tool default; blue/green deploy opt-in — Date: 2026-06-16 (updated 2026-06-16)
• 21. Usage-gap doc lookup: import/cache aliases + cross-channel telemetry — Date: 2026-06-16 (updated 2026-06-16)
• 22. Agent hint contract — lookup timing and validation semantics — Date: 2026-06-16 (updated 2026-06-16)
• ADR-0024: Shared HTTP MCP fleet for multi-window Cursor — Accepted (2026-06-16) (updated 2026-06-22)
• Agent Gateway Refusal Envelope — Field Spec — When a tapps-mcp or docs-mcp gateway fires, the tool response (or PreToolUse exit-2 body) (updated 2026-06-02)
• MCP Server Eager-Tool Budget — Default budget: 20 tools per MCP server (updated 2026-06-22)
• PRD: Zeek Network Intelligence Service — (updated 2026-04-05)
• Class Hierarchy (updated 2026-04-05)
• docs-mcp Dependency (updated 2026-04-05)
• docs-mcp Module Map (updated 2026-04-05)
• tapps-core Dependency (updated 2026-04-05)
• tapps-core Module Map (updated 2026-04-05)
• tapps-mcp Dependency (updated 2026-04-05)
• tapps-mcp Module Map (updated 2026-04-05)
• Architecture: Context7 Cache and Expert RAG — This document describes how the Context7 documentation cache and Expert RAG indices work, when they are creat... (updated 2026-04-05)
• Architecture Document Enhancement Plan — Reference: TappMCP Style Guide | HomeIQ Style Guide (updated 2026-04-05)
• Architecture Report (docs_generate_architecture) — Evaluation & Recommendations — Evaluated: docs/ARCHITECTURE.html generated for TappMCP (updated 2026-04-05)
• C4 — System Context — Auto-generated by docs_generate_diagram(diagram_type="c4_context", scope="project", format="mermaid", direction="LR"). (updated 2026-06-15)
• C4 — Container — Auto-generated by `docs_generate_diagram(diagram_type="c4_container", scope="project", format="mermaid", direction="T... (updated 2026-06-15)
• Module Map — Top-level project module map. Auto-generated by `docs_generate_diagram(diagram_type="module_map", scope="project", fo... (updated 2026-06-15)
• Architectural Archetype — Pattern Card — Auto-classified by docs-mcp's deterministic pattern classifier. tapps-mcp is detected as microservice with conf... (updated 2026-05-19)
• C4 — Component (tapps-mcp) — Internal components of the tapps_mcp package. Auto-generated by `docs_generate_diagram(diagram_type="c4_component",... (updated 2026-06-15)
• C4 — Component (docs-mcp) — Internal components of the docs_mcp package. Auto-generated by `docs_generate_diagram(diagram_type="c4_component", ... (updated 2026-06-15)
• ER — Structured Output Schemas — Pydantic models that define structuredContent for tapps-mcp tool responses. Source: packages/tapps-mcp/src/tapps_mc... (updated 2026-05-19)
• Sequence — TAPPS Quality Pipeline — The recommended tool call order for a coding session. Auto-generated by `docs_generate_diagram(diagram_type="sequence... (updated 2026-05-19)
• tapps-brain 3.22.0 — Integration Review for tapps-mcp + docs-mcp — Date: 2026-06-03 (updated 2026-06-15)

Configuration

• Tool-Description Eval: tool-selection accuracy A/B — Baseline: cc1d340^ (b7f0ba4) — HEAD: HEAD (7e31f2c) (updated 2026-05-19)
• Tool-Description Eval: tool-selection accuracy A/B (Phase A — clean noise floor) — Baseline: cc1d340^ (b7f0ba4) — HEAD: HEAD (4c11f2f) (updated 2026-05-21)
• outputSchema A/B (negative finding) — tapps_quick_check (B2) — Baseline: HEAD^=30149b1 (post-B1) — HEAD: 634ea57 (B2 candidate) (updated 2026-05-20)

Getting Started

• TappsMCP checklist (tapps_checklist) — The checklist tracks which MCP tools were invoked in the current checklist session and compares that to **tas... (updated 2026-06-12)
• GitHub Setup Guide — (updated 2026-06-22)
• 3. No PyPI or npm publish — global install from local checkout — Date: 2026-05-02 (updated 2026-05-12)
• 23. Immutable MCP CLI releases — no in-place uv tool reinstall — Date: 2026-06-16 (updated 2026-06-16)
• Architecture Decision Records — Architectural decisions for tapps-mcp / tapps-core / docs-mcp / tapps-brain. Each ADR follows the MADR template (Cont... (updated 2026-06-22)
• Archived Documentation — Regeneratable or supplementary docs kept out of the main tree to reduce noise for LLMs and developers. (updated 2026-06-16)
• Claude Code: Full Access Setup (No Permission Prompts) — This guide explains how to grant Claude Code 100% full access so it never asks for permission when using tools (B... (updated 2026-04-05)
• YouTube MCP Setup — The YouTube MCP server is configured for this workspace. It provides: (updated 2026-04-05)
• TappsMCP: Setup and Use Summary — TappsMCP is an MCP (Model Context Protocol) server that exposes code quality tools to LLMs (Claude, Cursor, e... (updated 2026-04-05)
• Archived smoke-test artifacts — DocsMCP generator smoke outputs moved here during the 2026-06 documentation refresh. (updated 2026-06-15)
• TappsMCP Diagrams — Auto-generated from source by docs-mcp. All diagrams render natively on GitHub. (updated 2026-06-22)
• Consumer repo: verify tapps-mcp ↔ tapps-brain wiring — Operator and agent checklist for wiring a new LLM coding repo to the shared (updated 2026-06-15)
• tapps-brain: Local and Multi-Project Setup — This guide explains how to connect tapps-mcp to tapps-brain for persistent memory. (updated 2026-06-09)
• TappsMCP Epics — Epics live in Linear, not in this repository. Per .claude/rules/linear-standards.md, create and update epics th... (updated 2026-06-16)
• Tutorials — Six short, copy-paste runnable walkthroughs for the most-asked starter tasks. Each ends with explicit verification st... (updated 2026-06-15)

Guides

• Call graph tools (consumer guide) — TappsMCP v3.12.31+ ships function-level call graph tools for Python projects (Epic 114, ADR-0017). Use them befor... (updated 2026-06-22)
• Getting Started with tapps-mcp — - Python 3.12+ (updated 2026-06-22)
• TappsMCP Design System Style Guide — Derived from: the HomeIQ Design System Style Guide (sibling repo, see workspace). (updated 2026-05-12)
• Tutorial: Add a new MCP tool to tapps-mcp — Time: ~15 minutes. Outcome: A working tapps_hello MCP tool callable from Claude Code, registered in the che... (updated 2026-05-18)
• Tutorial: Run the quality pipeline against a fresh Python project — Time: ~10 minutes. Outcome: A new Python project bootstrapped with TappsMCP scaffolding, a deliberate quality... (updated 2026-05-02)
• Tutorial: Wire tapps-brain into a Claude Code session — Time: ~20 minutes (10 of it is the brain HTTP service warming up the first time). Outcome: A Claude Code sess... (updated 2026-06-22)
• Tutorial: NLT MCP session modes — Time: ~10 minutes. Outcome: You enable the right 1–3 MCP servers for your task, verify tools appear in Cursor... (updated 2026-06-15)
• Tutorial: Documentation refresh workflow — Time: ~2 hours (full pass). Outcome: Tier-1 docs accurate, API/diagrams regenerated, link graph clean, CI doc... (updated 2026-06-15)
• Tutorial: Your first memory save and recall — Time: ~10 min (after tutorial 03 brain wiring). Outcome: Save a project decision, recall it in a new chat, an... (updated 2026-06-15)

Operations

• TappsMCP: Docker Deployment — Run TappsMCP as a local Docker MCP server using Streamable HTTP. The server listens on port 8000 and exposes ... (updated 2026-06-09)
• Docker Image Distribution — TappsMCP and DocsMCP are distributed as Docker images for external distribution, (updated 2026-05-12)
• Prompt: smoke-prompt — (updated 2026-06-15)
• Agent Teams Feature Gate Audit (TAP-2021) — Audit of every CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS gate in tapps-mcp. (updated 2026-05-27)
• Agent-facing Linear issues — conventions — Durable policy for how Linear issues are written, labeled, and nested in the (updated 2026-05-02)
• Brain-central doc RAG — fleet cutover runbook — Maintenance window (~30 minutes) for ADR-0014 big-bang cutover. (updated 2026-06-22)

Other

• Troubleshooting — Problem: When the MCP host (Claude Code, Cursor, VS Code) restarts or reloads, the MCP server connection is lost.... (updated 2026-06-17)
• 1. Smoke — Date: 2026-06-14 (updated 2026-06-14)
• 2. Smoke — Date: 2026-06-14 (updated 2026-06-14)
• 3. Smoke — Date: 2026-06-14 (updated 2026-06-15)
• Compaction Resilience Spec — Status: Active (updated 2026-06-16)

Planning

• TappsMCP Platform — Backlog Plan (Obsolete — see Linear) — This file is no longer maintained. The 49-issue plan generated on 2026-04-21 (updated 2026-05-05)
• PRD: Smoke — (updated 2026-06-15)
• Epic 111: Dependency Upgrade: Latest Stable Quality & Runtime Libraries — (updated 2026-06-15)
• Epic 112: Quality Tool Cross-Repo UX & Audit Hardening — (updated 2026-06-22)
• server_analysis_tools.py: honor project_root in MCP handlers — server_analysis_tools.py: honor project_root in MCP handlers (updated 2026-06-15)
• validate_changed.py: cross-repo explicit file_paths — validate_changed.py: cross-repo explicit file_paths (updated 2026-06-15)
• audit_chunker.py: auto-detect monorepo graph_root — audit_chunker.py: auto-detect monorepo graph_root (updated 2026-06-15)
• pip_audit.py: scope scan to target project — pip_audit.py: scope scan to target project (updated 2026-06-15)
• doctor.py: NLT tool-budget default bundle — doctor.py: NLT tool-budget default bundle (updated 2026-06-15)
• validate_changed_diagnostics.py: close EPIC-103 gaps — validate_changed_diagnostics.py: close EPIC-103 gaps (updated 2026-06-15)
• Handoff → tapps-brain: capabilities needed to unblock the "migrate local state into brain" epic (TAP-1996) — Status: requested by tapps-mcp 2026-06-01; revised 2026-06-09 after brain-side review. (updated 2026-06-09)
• Dogfood Retest Checklist (EPIC-113 / TAP-4026) — Run this checklist on the tapps-mcp dev repo after CallMcpTool unwrap (TAP-4017), rolling-stats filter (TAP-4025)... (updated 2026-06-15)

Release

• Init and Upgrade — Feature List — This document lists what each init-related process does. The codebase has two init flows plus *upgrade commands... (updated 2026-06-09)
• TappsMCP Platform — Sprint Board — Project: TappsMCP Platform (updated 2026-06-09)
• tapps-brain v2.1.0 — Tag Required — Date: 2026-04-07 (updated 2026-04-07)
• Generic upgrade prompt — pull latest tapps-mcp into a consuming project — Open Claude Code (or Cursor) inside the consuming project's repo and paste the prompt below. It works whether or ... (updated 2026-05-28)
• Upgrading TappsMCP — Guide for Consuming Projects — When you install or upgrade TappsMCP in a project that uses it for quality checks, doc lookup, and experts, you m... (updated 2026-06-16)
• Handoff — tapps-mcp consumer migration (brain EPIC-074/075 shipped) — Paste this into a tapps-mcp session (or a Linear comment on TAP-1997 / TAP-1998). (updated 2026-06-09)
• Brain v3.18.0 Kwarg Audit — TAP-1977 — Date: 2026-05-23 (updated 2026-06-13)
• tapps_memory Deprecation Migration Table (TAP-1991) — Status: REMOVED — v3.12.0 (TAP-1994, Phase 3 complete 2026-Q2). (updated 2026-06-01)
• Migration: <old_tool_name> → <new_tool_name> — Removed in: vX.Y.Z (updated 2026-05-23)
• Fleet maintenance — multi-repo TAPPS upgrade and audit — Runbook for upgrading tapps-mcp, AgentForge, NLTlabsPE, and NewCompanyIdeas together on one machine (... (updated 2026-06-17)