Introduction
Flashpoint.AI is a chat-driven research platform. Hand it a research objective in natural language and it plans the work, recruits respondents, fields the survey, analyzes the data, and delivers the artifacts. No survey software to learn — the surface is conversation.
💬 Join our community on Discord: discord.gg/QFWwknvvR4 — ask questions, share what you're building, and get help from the team.
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 all 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 autonomous agent run a panel and review 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
- Chat is the primary surface. Every action available in the API is also available by asking. The agent plans multi-step workflows, narrates as it works, and pauses for approval on anything destructive.
- Same model, same data, every channel. Whether you write to a survey through chat, the MCP tool, or the REST API, you read it back identically through any of them.
- Real respondents and synthetic respondents share a schema. Tag what you launched, analyze together or in segments.
- Predictable errors. 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.