Skip to content

docs(readme): link the MCP server from the top nav line - #449

Open
msgwing wants to merge 1 commit into
mainfrom
growth/readme-mcp-link
Open

msgwing wants to merge 1 commit into
mainfrom
growth/readme-mcp-link

Conversation

@msgwing

@msgwing msgwing commented Sep 20, 2026

Copy link
Copy Markdown
Owner

EVIDENCE: grep -rn "zerosmtp-mcp\|MCP" README.md README.de.md README.pl.md docs/*.md returned nothing before this change - zero discovery path from either entry point measured. tools/build-readme-toc.py's own header comment: 52 of 55 unique visitors in the last fortnight land on README.md, not on docs.msgwing.com. python tools/metrics.py --all today (2026-09-20): zerosmtp-mcp median 7 downloads/day over 14 days, against the >=25-by-2026-10-15 threshold in CLAUDE.md goal D.

The package (packages/zerosmtp-mcp/README.md) already has a working one-line try-now (a JSON MCP-client config block, second heading in the file) - it was simply unreachable. This adds one link to the top nav line of README.md, the same line that already links Quickstart/Code examples/FAQ.

Not a KLASY-gated file (packages/*/package.json, .github/workflows/*, data/*.json, docs/ALTERNATIVES.md per tools/check-board-review.py), so no BOARD: verdict required - confirmed by reading that script before opening this.

Verification run:

  • python tools/build-readme-toc.py --check -> passes unchanged (no heading touched, TOC untouched)
  • git diff -> one line changed in README.md

zerosmtp-mcp had no discovery path from README.md or docs.msgwing.com -
zero mentions in either, confirmed by grep. Per tools/build-readme-toc.py's
own comment, 52 of 55 unique visitors in the last fortnight land on
README.md, so that is where a missing link costs the most.

Measured 2026-09-20 via tools/metrics.py: zerosmtp-mcp median 7
downloads/day (14-day window), target is >=25 by 2026-10-15. The
package README already has a one-line try-now (JSON MCP config), it
was just unreachable from the two channels that carry traffic.
@msgwing
msgwing enabled auto-merge (squash) September 20, 2026 12:29
@github-actions github-actions Bot added the docs label Sep 20, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant