Skip to content

Docs drift: quickstart/tool counts/API key prefix inconsistent with live surface #41

@supertrained

Description

@supertrained

Summary

Several public surfaces disagree with the live product state after the email OTP rollout.

Repro / evidence

1) Quickstart says 21 MCP tools, live server exposes 16

Quickstart copy (https://rhumb.dev/quickstart) says:

"21 tools available: find_services, get_score, get_alternatives, get_failure_modes, execute_capability, and more."

Live MCP server:

npx -y @modelcontextprotocol/inspector --cli npx -y rhumb-mcp@latest --method tools/list

Actual result: 16 tools.

2) Quickstart shows rhumb_live_..., live signup issued rhumb_...

Dogfood signup flow:

  1. POST /v1/auth/email/request-code
  2. receive OTP email successfully
  3. POST /v1/auth/email/verify-code

Live response issued an API key with prefix:

rhumb_...

But Quickstart still shows examples like:

-H "X-Rhumb-Key: rhumb_live_..."

3) Public service-count copy disagrees across pages

  • Homepage hero says 1000 scored services
  • Homepage lower copy says 1,038 scored services
  • llms.txt also says 1,038 scored services

4) MCP install/config examples are inconsistent

  • README uses npx -y rhumb-mcp@latest
  • Quickstart MCP config currently shows command npx with args ["rhumb-mcp@latest"]

That may be okay in some contexts, but it no longer matches the safer README pattern and adds first-run ambiguity.

Expected

Public docs and onboarding copy should match the live surface:

  • accurate MCP tool count
  • accurate API key prefix
  • consistent service-count claims
  • one canonical MCP launch/config example

Impact

None of these are backend outages, but together they create avoidable trust friction exactly where a new user is trying to decide whether Rhumb is precise and reliable.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions