Introduction

Flashpoint.AI is a research platform you operate through chat. You describe a research objective in natural language. The platform plans the work, recruits respondents, fields the survey, analyzes the data, and returns the artifacts.

Three ways in

Surface	Who it's for	Where
Chat UI	Researchers, PMs, marketers — humans doing studies	app.flashpoint.ai
MCP server	Autonomous agents that pay per call (USDC over x402) and humans driving Flashpoint.AI from Claude Desktop	https://flashpoint.ai/mcp
REST API	Server-side integrations and back-office automation against the surveys service	See API Reference

The chat UI, the MCP server, and the REST API share the same domain model and the same data. You can start a study in chat and analyze it through the API, or have an agent run a panel and review the results in the UI.

What it covers

• Surveys — design with 20+ question types, skip logic, quotas, templates; lifecycle from draft to complete with versioning. Read more.
• Sample — AI-generated synthetic respondents, or real panels from Prolific and Dynata. Each source tagged for per-panel analysis. Read more.
• Distribute — public links, tracked email lists, panel-provider recruitment. Read more.
• Analyze — frequencies, crosstabs, NPS, chi-square, segment filters, AI-powered insights. Read more.
• Deliver — DOCX import, CSV / XLSX / Qualtrics / Confirmit / Forsta exports, presentation generation. Read more.

Design principles

1. Chat is the primary surface. Every action available in the API is also available through chat. The agent plans multi-step workflows, reports progress as it works, and requests approval before destructive actions.
2. All channels share one model. A survey written through chat, the MCP tool, or the REST API reads back identically through any of them.
3. Real and synthetic respondents share a schema. Responses are tagged by source, so you can analyze them together or separately.
4. Errors are predictable. Every failure mode has a documented code and an HTTP status. See Errors.

For agents

Every page in these docs is available as raw markdown. Replace the path prefix with /raw to fetch the source:

GET https://docs.flashpoint.ai/quickstart       → rendered HTML
GET https://docs.flashpoint.ai/raw/quickstart   → raw markdown (text/markdown)

Or click View as markdown at the top of any page.

What's here

• Quickstart — first tool call in under five minutes
• Connect from your AI assistant — per-client setup for Claude Desktop, Claude.ai web, Claude Code, and ChatGPT
• Authentication — three auth flavors: chat UI (Auth0), MCP for autonomous agents (wallet JWT), MCP for humans (OAuth via Claude Desktop)
• API Reference — every MCP tool, every request and response
• Errors — error codes and how to recover

Conventions

• Code samples default to curl. Tabs for language alternatives are coming.
• Field names in prose are wrapped in backticks: team_id, Authorization.
• Required parameters are flagged inline. Optional parameters note their default.