flowIQ for developers

flowIQ maps how teams actually work: captures (recorded walkthroughs and interviews) become step-by-step workflows, and multiple captures of the same process get synthesized into one process map. this page documents the hosted mcp server that lets ai agents read and act on that data.

hierarchy: workspace (organization) > teams > processes > captures.

getting started

1. sign in at app.simplestuff.ai and open settings > api keys (click your name in the sidebar, then workspace settings).
2. create a key. it starts with fiq_ and is shown once - store it somewhere safe. we only keep a hash.
3. connect an mcp client (below) or call the endpoint directly over json-rpc.

# quickest check: list the tools your key can call
curl -X POST https://app.simplestuff.ai/api/mcp \
  -H "Authorization: Bearer fiq_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

authentication

every request needs an api key, sent as Authorization: Bearer fiq_... or X-API-Key: fiq_.... keys are user-wide: one key works across every workspace you are a member of, and each call can target a workspace via the workspace_id parameter.

• up to 10 active keys per user.
• revoking a key (settings > api keys) disables it immediately.
• keys inherit your permissions - nothing more. a key can never see workspaces you are not a member of.

connect a client

the mcp server lives at https://app.simplestuff.ai/api/mcp (streamable http, stateless - no session handshake required).

claude code

claude mcp add flowiq --transport http https://app.simplestuff.ai/api/mcp \
  --header "Authorization: Bearer fiq_YOUR_KEY"

claude desktop / other json config clients

{
  "mcpServers": {
    "flowiq": {
      "type": "http",
      "url": "https://app.simplestuff.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fiq_YOUR_KEY"
      }
    }
  }
}

cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "flowiq": {
      "url": "https://app.simplestuff.ai/api/mcp",
      "headers": { "Authorization": "Bearer fiq_YOUR_KEY" }
    }
  }
}

how scoping works

keys are user-wide, so the workspace is chosen per call. tools that operate at workspace level take an optional workspace_id:

• omit it and the call uses your first workspace - fine if you only have one.
• pass it explicitly when you belong to several. list_workspaces returns the ids.
• membership is re-validated on every call. a workspace_id, process or capture you cannot access answers not_found - existence is never revealed across workspaces.

recommended flow for agents:

1. list_workspaces to see the options.
2. list_teams / list_processes to find the process.
3. list_captures + get_capture for recorded detail, get_synthesis for the merged process-level view.

tool reference

30 tools. reads mirror what a member sees in the app; writes are real and follow the same permission rules as the ui.

rate limits

errors

tool-level failures come back as mcp results with isError: true and a json body like {"error": "process_not_found"} - they are not http errors.