Falcon Builder MCP server

Falcon Builder MCP Server

Build, edit, and publish production AI agents from Claude, Cursor, ChatGPT, VS Code, or any MCP client. The Falcon Builder MCP server lets your assistant inspect executions, edit and duplicate workflows, run them, and publish them in your Falcon Builder workspace.

Available on every plan, including Free.

• Endpoint: https://www.falconbuilder.dev/api/mcp (Streamable HTTP)
• Docs: https://www.falconbuilder.dev/docs/mcp
• Registry name: dev.falconbuilder/falcon-builder

This is a hosted server. Nothing to install or run locally.

Connect

OAuth clients: claude.ai, Claude Desktop, ChatGPT

No token needed. The client registers itself automatically.

claude.ai / Claude Desktop

1. Settings → Connectors → Add custom connector
2. Server URL: https://www.falconbuilder.dev/api/mcp
3. Leave OAuth Client ID and Client Secret empty
4. Pick a workspace and the permissions to grant, then approve

ChatGPT Settings → Connectors → Create (turn on Developer Mode if prompted). Same URL, OAuth fields left empty.

Token clients: Claude Code, Cursor, VS Code, Gemini CLI

Create a token first: Falcon Builder → Settings → Developer, name it, choose permissions, and copy it. Tokens are shown once. Each workspace can have up to 10 active tokens.

Claude Code

claude mcp add --transport http falcon-builder \
  https://www.falconbuilder.dev/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "falcon-builder": {
      "url": "https://www.falconbuilder.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json). VS Code prompts for the token and stores it securely.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "falcon-token",
      "description": "Falcon Builder API token (Settings > Developer)",
      "password": true
    }
  ],
  "servers": {
    "falcon-builder": {
      "type": "http",
      "url": "https://www.falconbuilder.dev/api/mcp",
      "headers": { "Authorization": "Bearer ${input:falcon-token}" }
    }
  }
}

Gemini CLI (~/.gemini/settings.json). Use httpUrl; in Gemini CLI, url means SSE.

{
  "mcpServers": {
    "falcon-builder": {
      "httpUrl": "https://www.falconbuilder.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Permissions

You choose these when you connect over OAuth or create a token. Read is always included.

Tools

Read whoami, switchworkspace, listagents, listworkflows, getworkflow, getworkflowdefinition, getworkflownode, validateworkflow, listexecutions, getexecution, getexecutionlogs, listworkflowversions, listinterfaces, get_interface

Edit drafts createworkflow, editworkflow, duplicateworkflow, duplicateagent, createinterface, updateinterface, addinterfaceaccessrule, removeinterfaceaccessrule, delete_interface

Run workflows runworkflow, rerunexecutions

Publish & rollback publishworkflow, rollbackworkflow, publish_interface

Every tool declares MCP annotations (read-only, destructive, idempotent, open-world), so clients that honor them can ask before anything changes. runworkflow and rollbackworkflow also require an explicit confirm: true.

Things to ask your assistant

Shortened. The full README is on GitHub.