Flashpoint.AIFlashpoint.AIdocs

Connect from your AI assistant

Plug Flashpoint.AI into Claude or ChatGPT and sign in with your normal Flashpoint.AI account — no API keys or tokens to copy. Usage is covered by your Flashpoint.AI subscription.

Server URL: https://api.flashpoint.ai/mcp

For the protocol details (OAuth 2.1, JWT shape, RFC references), see Authentication. For your first tool call walkthrough, see Quickstart.

Claude Desktop

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Paste the server URL: https://api.flashpoint.ai/mcp
  4. Click Add, then Connect.
  5. A browser window opens — log in with your Flashpoint.AI account.
  6. Pick the team you want this connection to use.

Done — Flashpoint.AI tools now show up in Claude.

Claude.ai (web)

  1. Go to Settings → Connectors on claude.ai.
  2. Click Add custom connector.
  3. Paste the server URL: https://api.flashpoint.ai/mcp
  4. Click Connect, log in with your Flashpoint.AI account, and pick a team.

Claude Code (CLI)

claude mcp add --transport http flashpoint https://api.flashpoint.ai/mcp

The first time you use a Flashpoint.AI tool, a browser window opens to log in and pick your team.

ChatGPT (custom connector)

  1. In ChatGPT, open Settings → Connectors → Add custom connector.
  2. Paste the server URL: https://api.flashpoint.ai/mcp
  3. Click Connect, log in with your Flashpoint.AI account, and pick a team.

What you can do once connected

  • Surveys, end to end — plan, design (20+ question types, logic, quotas, translations), QA with the logic prover, publish, recruit paid respondents from Prolific / Dynata / Cint, distribute by email, analyze (crosstabs, NPS, conjoint simulator) and export. All of it through one tool, tool_survey.
  • Synthetic respondents — build a persona panel and run it through a survey (panel).
  • Demographics for any place (demographics) and native PowerPoint decks (presentation).
  • Everything else the Flashpoint.AI orchestrator does — ad experiments, research scoping, team files, maps — through chat.

Money and destructive actions (publishing, deleting, sending email, paying for sample) always ask you to confirm on a second message before anything happens. Interactive cards such as the results dashboard, conjoint simulator, and checkout open in the web app; every conversation you have over MCP also shows up at app.flashpoint.ai.

The full tool list with parameters is in the API Reference, and every capability of the surveys agent, tool by tool, is in the MCP capability reference.

How sign-in works

When you click Connect, your assistant kicks off an OAuth 2.1 flow:

  1. Your assistant registers itself with the Flashpoint.AI MCP server.
  2. Your browser opens at auth.flashpoint.ai — log in with your normal Flashpoint.AI credentials.
  3. You see a team picker — pick which team this connection should act as. Tools you call will read and write data for that team.
  4. Your assistant receives a session token bound to (your user, that team) with a 24-hour expiry.

The session refreshes automatically. You can connect more than one assistant at the same time — each gets its own session. To switch the team a connection acts as, remove the connector and add it again — you'll get the team picker on the next sign-in.

If you're building an autonomous agent (no human in the loop) rather than connecting an assistant for a person, use the Wallet JWT flow instead.

Troubleshooting

"Couldn't connect" before a browser opens. Make sure you pasted the URL exactly: https://api.flashpoint.ai/mcp — including the /mcp suffix.

Login page errors. Close the browser tab and start the connection again from your assistant. If you see "callback URL mismatch" repeatedly, contact support — that's a server-side config issue.

Tool calls fail after connecting. Disconnect the connector in your assistant's settings and re-add it — that forces a fresh login. If it still fails, include the client (Desktop / web / Code / ChatGPT), the team you picked, and the time of the failed call when you report it.

"Unauthorized" mid-session. Your session expired and the assistant didn't refresh it. Reconnect once.