Documentation

Everything you need — and nothing you don't.

The docs mirror the codebase's discipline: contracts first, then examples, then troubleshooting. Every command, event, and MCP tool is here.

Get running in a minute

The one-command install.

# Install the CLI (optional)
$ pip install telepace-cli

# Or use the MCP directly in Claude Code
$ claude mcp add telepace https://mcp.telepace.io

# Create your first campaign
$ telepace campaigns create \
    --title "Why do users abandon onboarding?" \
    --goal "Understand the first-run friction" \
    --channel web_text \
    --target 25

  ✓ campaign_id: 4f2b…9c1
  ✓ share_url:  https://telepace.io/r/4f2b9c1
  ✓ next_actions:
      · dispatch invites via email
      · watch progress: telepace campaigns progress 4f2b9c1

Quickstart

In 60 seconds

Create a study, share the URL, watch the first completion arrive.

In 15 minutes

Wire the MCP server into Claude Code and let your agent do research.

In an hour

Full production deploy — event store on Postgres, Redis, Fly.io.

Core concepts

Campaigns

A study lifecycle: draft → published → closed. Immutable event history.

Interviews

One respondent completing the outline. Text, voice, phone, or email.

Insights

Themes clustered from transcripts with representative verbatims.

Harness

Policy-gated dispatcher between commands and agents.

Integrations

MCP

5 stateful tools. Compatible with any MCP host.

REST API

OpenAPI schema at /openapi.json. Bearer auth.

Notion

One-way push of insights into a database.

Linear

Create issues per insight, grouped by theme.

Webhooks

Any of our 20+ event types, HMAC-signed.

Reference

Command schemas

CreateCampaign, RefineOutline, StartCampaign …

Event schemas

20+ append-only event types with schema_version.

MCP tool schemas

Input/Output Pydantic pairs for every tool.

Still stuck?

We answer support in hours, not days.