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://flashpoint.ai/mcp
For Claude Code (CLI), use:
claude mcp add --transport http flashpoint https://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 get_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" | surveys_agent | A draft survey via the surveys agent |
| "Run that survey on a synthetic panel of 50 marketing managers" | synthetic_panel_take_survey | AI personas answer per their demographic profile |
| "Build a deck from the results" | create_presentation | Native .pptx with editable charts |
| "Plan a multi-step study about Gen Z banking habits" | chat | Full orchestrator — plans, executes, narrates |
What you just used
https://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