Quickstart
Run your first Flashpoint.AI tool call from your AI assistant in under five minutes. Works with Claude Desktop, Claude.ai web, Claude Code, ChatGPT custom connectors, and other MCP-compatible clients (Cursor, Cline, Continue, custom).
1. Add the Flashpoint.AI MCP server
Paste this URL into your assistant's MCP / custom-connector settings:
https://api.flashpoint.ai/mcp
For Claude Code (CLI), use:
claude mcp add --transport http flashpoint https://api.flashpoint.ai/mcp
The --transport http flag is required for the CLI path — without it the CLI assumes stdio and treats the URL as a subprocess command.
Per-client steps (Desktop, web, Code, ChatGPT) live in Connect from your AI assistant.
2. Sign in
The first time you call a Flashpoint.AI tool, Claude opens your browser to Flashpoint.AI's Auth0 login. After you sign in:
- Flashpoint.AI loads the teams you belong to.
- A team picker page asks which team this Claude session should act as.
- Click the team. Claude receives an access token bound to your
user_id+team_idfor 24 hours and registers the connection.
The token is scoped to the team you picked. To switch teams, re-run the connection from Claude.
3. Try a tool
Ask Claude:
"Use Flashpoint.AI to get demographics for San Francisco."
Claude calls the demographics MCP tool. You get back population, age, race, gender, education, and income distributions with AI-powered insights — sourced from US Census Bureau data for US locations, international city profiles otherwise.
Other tools you can try:
| Ask Claude | Tool called | What you get |
|---|---|---|
| "Build me a 10-question NPS survey for SaaS buyers" | tool_survey | A draft survey via the surveys agent |
| "Add a quota of 50% women, translate it to Spanish, and run surveycheck" | tool_survey | Quotas, a second language, and a logic-prover report on the same survey |
| "Recruit 50 Prolific respondents for it — quote first" | tool_survey | A price quote, then on your confirmation a secure checkout link |
| "Show me the crosstab of satisfaction by age and export to XLSX" | tool_survey | Analysis plus a download |
| "Create 50 synthetic marketing managers and run them through that survey" | panel | AI personas answer per their demographic profile |
| "Build a deck from the results" | presentation | Native .pptx with editable charts |
| "Plan a multi-step study about Gen Z banking habits" | chat | Full orchestrator — plans, executes, narrates |
Anything about a survey goes to tool_survey; the full capability list is in the API Reference.
What you just used
https://api.flashpoint.ai/mcp— the Flashpoint.AI MCP server, speaking the MCP Streamable HTTP transport. Claude discovers our OAuth flow via the standard well-known endpoints; see Authentication for the details.- Your access token is an HS256 JWT issued by mcp-server, bound to
(user_id, team_id), 24-hour expiry. Stored locally by Claude — never copy-pasted, never visible to you. - Per-call billing for human users is bundled with your Flashpoint.AI subscription. Autonomous wallet agents pay per call in USDC over x402 — see Authentication › Wallet JWT.
Next steps
- Read Authentication for the three auth flavors and when to use which
- Browse every tool with parameters and return shapes in the API Reference
- For survey design, panels, and analysis, jump to Surveys
- Map error codes to recovery in Errors