Skip to content

docs(readme): reconcile tool-count contradictions (TAP-4577) #200

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
wtthornton merged 1 commit into from
Jul 2, 2026
Merged

docs(readme): reconcile tool-count contradictions (TAP-4577) #200

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ tapps-brain (standalone) <── tapps-core (shared infra) <── tapps-mcp

### Key highlights

- **84 deterministic MCP tools** (42 TappsMCP + 42 DocsMCP) — no LLM calls in the tool chain; same input always produces same output
- **85 deterministic MCP tools** (43 TappsMCP + 42 DocsMCP) — no LLM calls in the tool chain; same input always produces same output
- **Multi-language code scoring** - Python, TypeScript/JavaScript, Go, Rust across 7 categories (complexity, security, maintainability, test coverage, performance, structure, devex)
- **Documentation lookup** via Context7 and LlmsTxt providers with local caching
- **Persistent shared memory** via [tapps-brain](https://github.com/wtthornton/tapps-brain) — project decisions survive across sessions. TappsMCP accesses the Dockerized brain service over HTTP via BrainBridge; use `uv run tapps-mcp memory` (42 actions) or enable `nlt-memory` for MCP-exposed recall/save/handoff tools. See the [tapps-brain repo](https://github.com/wtthornton/tapps-brain) for retrieval, decay, consolidation, and federation internals.
Expand Down Expand Up @@ -101,7 +101,7 @@ Any MCP-capable client (Claude Code, Cursor, VS Code Copilot, Claude Desktop, cu

## Features

The platform exposes **84 MCP tools** (42 TappsMCP + 42 DocsMCP) plus workflow prompts. All tools are **deterministic** (no LLM calls in the tool chain).
The platform exposes **85 MCP tools** (43 TappsMCP + 42 DocsMCP) plus workflow prompts. All tools are **deterministic** (no LLM calls in the tool chain).

### Code quality & scoring

Expand Down Expand Up @@ -1072,7 +1072,7 @@ tapps-core (shared infrastructure)
^ ^
| |
tapps-mcp docs-mcp
(42 tools) (42 tools)
(43 tools) (42 tools)
```

**[tapps-brain](https://github.com/wtthornton/tapps-brain)** is the standalone memory service extracted from tapps-core. It runs as a Dockerized Postgres-backed service that TappsMCP clients reach over HTTP at `localhost:8080`. Storage engine, retrieval (BM25 + boosts), time-based decay, contradiction detection, consolidation, federation, and GC internals all live in the [tapps-brain repo](https://github.com/wtthornton/tapps-brain) and its README/CHANGELOG — refer there for the authoritative description so this page doesn't drift. tapps-brain has its own release cycle and test suite.
Expand Down Expand Up @@ -1204,7 +1204,7 @@ packages/
│ ├── metrics/ # Collector, dashboard, alerts, trends, OTel export
│ └── adaptive/ # Adaptive scoring, expert voting, weight distribution
│
├── tapps-mcp/ # Code quality MCP server (42 tools)
├── tapps-mcp/ # Code quality MCP server (43 tools)
│ └── src/tapps_mcp/
│ ├── server.py, cli.py # Entry points and MCP server
│ ├── server_*.py # Tool modules (scoring, pipeline, metrics, memory, analysis)
Expand Down