Docs: Overview

Build on CareChannel

CareChannel is a customer-feedback platform: boards, posts, votes, comments, roadmaps and a changelog. Everything the web app does is also an operation you can call, in three ways:

  • MCP for AI clients such as Claude, ChatGPT or VS Code. Each workspace has its own server at https://ballot.jumpstartsolutions.co/w/{workspace}/mcp. Connect an AI client.
  • REST at https://ballot.jumpstartsolutions.co/api/v1, described by an OpenAPI document, with a typed TypeScript client. REST API and typed client.
  • Example apps that show both in use: an internal feedback-logging form and a custom roadmap page. Example apps.

All 119 operations are generated from one registry, so MCP tools, REST routes, the typed client and these docs always match. The tool reference lists each one with who may call it and its fields.

Rules every surface shares

  • Every change is recorded in the workspace's audit log, and most can be undone.
  • Creates accept an idempotency key, so a retry never posts twice. Updates accept expected_version and refuse stale edits.
  • Destructive operations need confirm: true and support dry_run: true to preview the effect first.
  • Anything that emails customers says so, and accepts notify.
  • Errors carry a stable code (validation_failed, forbidden, not_found, version_conflict, …) and a message that lists valid values.