Honest Pitches MCP Server

A permanent page where you can sell something, with audience ratings that prove whether your pitch is any good.

Tools

• create_pitch

  Create a new pitch in draft status with framework and sections

• get_pitch

  Fetch a pitch by Appwrite document id. NOTE: auto-generated media (thumbnail, OG image) live on the pitch row as `thumbnailFileId` / `ogImageFileId` — they are NOT in `pitch_assets`. For a complete media listing (uploaded + auto-generated, with `source` discriminator), call `list_pitch_media` instead of reading `sections[].mediaIds` here. After a `to=preview` transition, read `previewToken` from the row (the response-time `meta.previewUrl` is only set when a new token was minted in the same call

• list_pitches

  List pitches with optional status / creatorId filter

• list_pitch_media

  List every media asset for a pitch: uploaded (in pitch_assets) AND auto-generated (thumbnailFileId, ogImageFileId on the row). Each result has `source: 'pitch_assets' | 'pitch_row'` discriminator.

• update_pitch

  Update a draft pitch (framework locked after preview)

• transition_pitch_status

  Move pitch lifecycle: draft ↔ preview ↔ live → expired → archived. STATUS vs LIFECYCLE: `lifecycle` is the canonical, computed view (`draft | preview | live | expired | archived`); `status` is the row-level primitive (`draft | pending_payment | live | expired | removed`). Mapping: `draft→draft`, `preview→draft` (previewToken set), `live→live`, `expired→expired`, `archived→removed` (intentional rename). BRANCH ON `lifecycle` for terminal-state checks; `lifecycle === 'archived'` is the canonical a

• list_frameworks

  List registered pitch frameworks (read-only)

• get_framework

  Get one framework definition by id

• get_segment

  Get segment definition by SectionKind

• suggested_sections_for_framework

  Return PitchSection stubs for a framework

• scaffold_pitch_from_framework

  Build a CreatePitchInput draft locally (no network)

• get_my_creator

  Resolve the caller's creators.$id from their authenticated Appwrite userId. Returns { creatorId: string | null } — null if the user has no creators row yet (sign in via studio once so user-onboard runs). The SDK's pitches.create / .update / .transition also do this lookup server-side as a defense-in-depth check; this tool lets CLI / agent surfaces get the value up front so they can pass it as creatorId without a separate round-trip.