Quickstart
Three steps from zero to a 200 OK. No SDK install required — every endpoint is a plain HTTP call authenticated with a Bearer token.
Create a key
Generate an API key in your Premier account. Free tier includes 2,000 credits.
Ping the API
Run the curl on the right. Replace YOUR_API_KEY with the key you just created.
You’re in.
Browse the full reference below, or jump to Public REST / Remote MCP.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://fluenta.space/backend/api/v1/ext/ping{
"success": true,
"data": { "ok": true }
}Connect
Fluenta exposes a Remote MCP server (JSON-RPC 2.0). Drop the snippet below into Claude Desktop or click through to install in Cursor — every X-Ray tool, idea search, and bookmark action becomes available to your agent.
Stays in your browser. Never sent to Fluenta. Leave blank to use a placeholder.
Paste this into claude_desktop_config.json, then restart Claude.
{
"mcpServers": {
"fluenta": {
"url": "https://fluenta.space/backend/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_FLUENTA_API_KEY"
}
}
}
}Config location: ~/Library/Application Support/Claude/ (macOS) · %APPDATA%\Claude\ (Windows).
One click. Cursor will prompt you to confirm the install.
If your browser blocks the cursor:// handler, Cursor accepts the same JSON snippet shown on the left under ~/.cursor/mcp.json.
fluenta_idea_x-ray_sandbox — free instant preview. No credits, no user-data writes. Use as the default reconnaissance tool when an agent wants a quick read.fluenta_idea_x-ray — the full paid X-Ray. Requires a read_write key and 2,000 credits per run. Returns xray_submitted while queued, then xray_result when complete.Concepts
Every call carries Authorization: Bearer YOUR_API_KEY. Keys are tied to your Premier account and never expire until you revoke them. The OpenAPI document at /api/v1/ext/openapi.json is the only public endpoint and requires no key.
Manage keys →Two scopes. read — search ideas, read analyses, list collections, read pipeline and usage. read_write — everything in read, plus submit X-Ray analyses and add or remove pipeline bookmarks. Pick the smallest scope your integration needs.
Standard HTTP codes. 401 = bad or revoked key. 402 = out of credits or key limit exceeded. 403 = wrong scope for the action. 429 = rate limited. 500 = server error. The response envelope follows { success: false, error: { ... } } — see the per-endpoint reference below for exact shape.
Limits are enforced per API key. When exceeded you get a 429 with a Retry-After header. Implement exponential backoff. Specific RPS thresholds will be published here once finalized — meanwhile email [email protected] for high-volume use cases.
Create one in 30 seconds. Free tier includes 2,000 credits — enough for one X-Ray run plus unlimited reads.
BearerAuth field.