Vouch
Docs · MCP

Vouch MCP server

Connect your AI IDE (Cursor, Claude Desktop, Windsurf, Zed) to your Vouch workspace over the Model Context Protocol. Your interviews, assumptions, and segments become first-class, read-only context for any AI assistant you use.

Endpoint: https://vouch.specky.space/api/public/mcp
Transport: MCP Streamable HTTP (POST)
Auth: Authorization: Bearer vch_…

Why connect Vouch over MCP

Your customer interviews, ranked assumptions and segment scores are the highest-signal context for any product decision an AI assistant can help with. Over MCP you can:

  • Ground roadmap or spec drafts in real customer quotes (every excerpt is citable).
  • Ask "what do we already know about X?" before scheduling another interview.
  • Cross-check a proposal against the project's open assumptions.

Setup

  1. Sign in at vouch.specky.space.
  2. Open /settings/mcp, click Generate token, and copy the vch_… value (shown once).
  3. Add the server to your IDE config below.

Cursor / Claude Desktop / Windsurf

{
  "mcpServers": {
    "vouch": {
      "url": "https://vouch.specky.space/api/public/mcp",
      "headers": {
        "Authorization": "Bearer vch_YOUR_TOKEN_HERE"
      }
    }
  }
}

Zed

{
  "context_servers": {
    "vouch": {
      "command": {
        "path": "npx",
        "args": [
          "-y", "mcp-remote",
          "https://vouch.specky.space/api/public/mcp",
          "--header", "Authorization: Bearer vch_YOUR_TOKEN_HERE"
        ]
      }
    }
  }
}

Tools exposed

ToolPurpose
list_projectsList your projects with id, name, idea, target customer, and counts.
get_projectFull project — assumptions, interviews, segments, pilots, cases.
search_interviewsKeyword search across all interviews. Returns citable excerpts with interviewee, company, date.
get_assumptionsAssumptions with FeDeVi category, importance, and evidence strength.
get_segmentsCandidate segments with 12-dimension scores and reasoning.

All tools are scoped to the authenticated user — tokens never see another user's data.

Recommended prompts

  • "Use Vouch to list my projects, then summarize what's been validated for the [name] idea."
  • "Search interviews in project [id] for 'pricing' and quote the three strongest objections."
  • "Read assumptions for project [id]. Which Desirable assumptions still have weak evidence?"
  • "Get segments for project [id] and recommend which one to pursue first, citing scores."

Security

  • Tokens are SHA-256 hashed at rest; the raw vch_… value is only displayed once.
  • Revoke anytime at /settings/mcp. Revoked or invalid tokens return HTTP 401 with a WWW-Authenticate hint.
  • Suspicious activity (high failure rate, multiple IPs per token, burst usage, use after revocation) is surfaced in /settings/mcp and the admin console.
  • Read-only: the MCP server cannot create, edit, or delete projects, interviews, or assumptions.

Error reference

CodeMeaningFix
401 missingNo Authorization header.Add Authorization: Bearer vch_… from /settings/mcp.
401 invalid_tokenToken not recognized.Generate a new one at /settings/mcp.
401 token_revokedToken was revoked.Generate a new one and update your IDE config.
405GET or DELETE attempted.MCP Streamable HTTP uses POST.
406Client missing Accept header.Use a real MCP client; don't hand-roll fetch.

Spec & implementation