Fluenta MCP server

Remote MCP server that scores business ideas on six live market signals. Run an Idea X-Ray from Claude, Cursor or any MCP client and get a Launch Readiness Score (LRS) across demand, pain, competition, monetisation, timing and distribution, plus search over thousands of already-scored ideas.

• Endpoint: https://fluenta.space/backend/api/v1/mcp (Streamable HTTP, JSON-RPC 2.0)
• Docs: fluenta.space/docs/api-and-mcp
• OpenAPI: openapi.json
• Website: fluenta.space

This repository holds the registry manifest (server.json) and the integration notes. The server itself is hosted by Fluenta; there is nothing to install or run locally.

Tools

Tool	What it does
fluenta_idea_x-ray_sandbox	Instant preview of an idea's Launch Readiness Score (LRS). No credits, no writes. Use it as the default first look.
fluenta_idea_x-ray	The full X-Ray. Scores the idea on six live signals. Returns xray_submitted while queued and xray_result when complete.
fluenta_search_ideas, fluenta_get_idea, fluenta_compare_ideas	Search and compare the scored-ideas database.
fluenta_list_collections, fluenta_get_pipeline, fluenta_add_to_pipeline, fluenta_remove_from_pipeline	Manage your idea pipeline.
fluenta_list_analyses, fluenta_list_xray_runs, fluenta_download_report	History and reports.
fluenta_get_account, fluenta_get_usage	Account state and usage.

Authentication

Create an API key in your Fluenta account (Settings, API 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.

Send the key as Authorization: Bearer YOUR_FLUENTA_API_KEY.

Claude Desktop

Add to claude_desktop_config.json and restart Claude:

{
  "mcpServers": {
    "fluenta": {
      "type": "http",
      "url": "https://fluenta.space/backend/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_FLUENTA_API_KEY" }
    }
  }
}

Config location: ~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows.

Cursor

Same JSON in ~/.cursor/mcp.json, or use the one-click install button on the docs page.

Claude Code

claude mcp add --transport http fluenta https://fluenta.space/backend/api/v1/mcp --header "Authorization: Bearer YOUR_FLUENTA_API_KEY"

Example prompts

• "Run a sandbox X-Ray on: a subscription service for restaurant menu translation."
• "Search Fluenta for scored ideas about AI bookkeeping and compare the top three."
• "Add the best result to my pipeline."

Errors and limits

Standard HTTP codes. 401 is a bad or revoked key, 402 is out of credits or key limit exceeded, 403 is the wrong scope for the action, 429 is rate limited (respect Retry-After). The response envelope on failure is { "success": false, "error": { ... } }.

Registry

Published to the official MCP Registry as io.github.Fluenta-Team/fluenta from the server.json in this repository.

Licence

MIT for the contents of this repository. Use of the hosted service is governed by the Fluenta Terms of Service.