MCP Server

The XainFlow MCP server lets AI assistants interact with your workspace using natural language. Generate images, videos, audio, build workflows, manage assets, and more — directly from Claude.ai, Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.

What is MCP?

The Model Context Protocol (MCP) is an open standard that connects AI assistants to external tools. When you connect XainFlow as an MCP server, your AI assistant gains access to 40+ tools that cover your entire creative workflow — including image and video generation, audio production, asset management, workflow execution, skills, and external connectors like Monday.com.

Prerequisites

A XainFlow workspace (Starter plan or above)
An API key with appropriate scopes — see API Access
An MCP-compatible client (Claude.ai, Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, etc.)

Generate an API Key

Go to Workspace Settings > API Keys in XainFlow.
Click Create API Key.
Select scopes: read, write, generate.
Copy the key (starts with xf_live_).

tip

After creating an API key, XainFlow shows pre-configured setup snippets with your key already filled in. Just copy and paste into your client.

Setup by Client

Claude.ai (Web and Mobile)

You can add XainFlow directly to Claude.ai as a connector. This works on Pro, Max, Team, and Enterprise plans.

Open Claude.ai and click your profile icon in the bottom-left corner.
Go to Settings > Connectors.
Scroll down and click Add custom connector.

Enter the XainFlow MCP server URL:

https://api.xainflow.com/functions/v1/mcp

Click Add to save the connector.

Once added, enable XainFlow in any conversation:

Click the + button at the bottom-left of the chat input.
Select Connectors.
Toggle XainFlow on.

Now you can ask Claude to generate images, manage assets, build workflows, and more — right from the chat.

info

Claude.ai connectors use OAuth for authentication. You'll be prompted to authorize XainFlow the first time you enable the connector. No API key is needed for this method.

For more details on connectors, see Anthropic's guide: Getting started with custom connectors using remote MCP.

Claude Code

claude mcp add xainflow -t http \
  --header "X-API-Key:xf_live_YOUR_KEY_HERE" \
  https://api.xainflow.com/functions/v1/mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "xainflow": {
      "url": "https://api.xainflow.com/functions/v1/mcp",
      "headers": {
        "X-API-Key": "xf_live_YOUR_KEY_HERE"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "xainflow": {
      "url": "https://api.xainflow.com/functions/v1/mcp",
      "headers": {
        "X-API-Key": "xf_live_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf / VS Code

Add to .vscode/mcp.json in your project:

{
  "mcpServers": {
    "xainflow": {
      "url": "https://api.xainflow.com/functions/v1/mcp",
      "headers": {
        "X-API-Key": "xf_live_YOUR_KEY_HERE"
      }
    }
  }
}

Available Tools

The MCP server exposes 40+ tools organized into the categories below. Credit costs match the web UI.

Workspace and Assets

Tool	Description
`xainflow_list_workspaces`	List all workspaces you can access
`xainflow_switch_workspace`	Change the active workspace for subsequent calls
`xainflow_get_context`	Fetch workspace + project brand context (logo, colors, variables, styles) — project values override workspace values
`xainflow_get_credits`	Check your credit balance breakdown
`xainflow_list_projects`	List or get projects with optional folders
`xainflow_create_project`	Create a new project
`xainflow_list_assets`	Browse assets with filters and pagination
`xainflow_list_styles`	List available generation styles
`xainflow_list_variables`	List prompt variables (returns `default_index` for each variable)
`xainflow_manage_folders`	Create, rename, move, or delete folders
`xainflow_manage_assets`	Move, rename, or delete assets (bulk)
`xainflow_import_from_url`	Save an external URL as a workspace asset
`xainflow_analyze_asset`	Run vision analysis on an asset to extract a description
`xainflow_get_model_config`	Reference current image/video model IDs and capabilities

Image Generation

Tool	Description
`xainflow_generate_image`	Generate images with 8 AI models (Z-Image, Grok Imagine, Nano Banana / Pro, SeeDream 4.5 / 5.0 Lite, Recraft V3, GPT Image 2). Supports `quality` (low / medium / high) for GPT Image 2

Video Generation

Tool	Description
`xainflow_generate_video`	Generate videos (async) with Veo 3.1 / 3.1 Fast / 3.1 Lite, Sora 2 / Sora 2 Pro, Kling V3 / O3, Seedance 1.5 Pro / 2.0
`xainflow_get_video_status`	Poll video generation status until complete
`xainflow_video_edit`	Edit videos: concat, trim, merge audio, effects, GIF conversion
`xainflow_video_probe`	Inspect video metadata (duration, resolution, format) — free
`xainflow_get_video_edit_status`	Poll async video edit job status
`xainflow_add_audio_to_video`	Merge voice, music, or AI-generated SFX into a video
`xainflow_renderMotion`	Render a Motion Studio (Remotion) template to video — 75 cr/s

Audio and Voice

Tool	Description
`xainflow_voices`	List system + custom voices, or clone a new voice from an audio sample
`xainflow_text_to_speech`	Generate speech from text with a system or custom voice
`xainflow_generate_music`	Generate music tracks — Standard (ACE-Step, 0.2 cr/s) or Premium (ElevenLabs, 800 cr/min)
`xainflow_generate_sfx`	Generate sound effects from text descriptions (Stable Audio, 1 cr/s)

Image Processing (AI Suite)

Tool	Description
`xainflow_remove_background`	Remove image background — 20 credits
`xainflow_upscale`	Upscale image resolution — 10 cr base, dynamic by megapixels
`xainflow_vectorize`	Convert image to SVG vector — 10 credits
`xainflow_image_expand`	Expand image canvas with AI outpainting — 40 credits
`xainflow_multi_angle`	Generate multi-angle product views — 35 cr base
`xainflow_generate_3d`	Generate a 3D model from an image (Trellis 2) — 250-350 credits
`xainflow_crop_image`	Crop an image to coordinates — free
`xainflow_resize_image`	Resize an image to target dimensions — free

Workflow Management

Tool	Description
`xainflow_workflows`	List, filter, or delete workflows
`xainflow_get_workflow`	Get workflow detail with node and edge data
`xainflow_build_workflow`	Create a new workflow from a structured DSL
`xainflow_update_workflow`	Rename, move, or update a workflow
`xainflow_batch_modify`	Apply atomic multi-operation edits to a workflow
`xainflow_batch_execute`	Run a workflow server-side
`xainflow_execute_workflow`	Execute a single workflow synchronously
`xainflow_get_workflow_run`	Get run status and outputs
`xainflow_create_from_template`	Clone a template into a new workflow
`xainflow_blocks`	List, get, create, update, delete, or publish reusable Blocks

Skills

Tool	Description
`xainflow_skills`	List, get, create, update, or clone skills (workspace, project, or Hub)

Skills can be authored interactively from your IDE — see Creating Skills for the full workflow, including the skill-creator evaluation tooling.

Monday.com

These tools are exposed when the Monday.com connector is enabled in your workspace. The Main Agent uses them automatically when @mentioned in a Monday item or subitem.

Tool	Description
`monday_list_boards`	List boards in the connected Monday.com workspace
`monday_get_board`	Get board metadata and groups
`monday_get_board_columns`	Get column schema for a board
`monday_get_item`	Get an item with its column values
`monday_create_update`	Post an update (comment) to an item
`monday_update_column_values`	Set column values on an item (schema-aware)
`monday_create_subitem`	Create a subitem under a parent item
`monday_move_item_to_group`	Move an item between groups on a board

See Main Agent — Integrations for setup details.

Usage Examples

Check your workspace

You: "What's my XainFlow workspace looking like?"

The AI assistant calls xainflow_get_context + xainflow_get_credits and reports your plan, credit balance, project count, and brand context.

Generate images

You: "Generate 4 product photos of running shoes using the minimalist style"

The assistant finds the style, checks your credits, generates the images, and confirms the cost.

Build and run a workflow

You: "Create a workflow that generates product photos from a text prompt, then removes the background"

The assistant creates a workflow with Prompt Generator, Image Generator, and Remove Background nodes, then offers to execute it.

Use a template

You: "Show me workflow templates and use the best one for product photos"

The assistant lists templates, clones one, and executes it.

Troubleshooting

No tools showing up

Verify the URL is https://api.xainflow.com/functions/v1/mcp (no trailing slash).
Ensure the X-API-Key header is set correctly (not needed for Claude.ai — it uses OAuth).
For Claude Code, run claude mcp list to verify configuration.

UNAUTHORIZED errors

Verify your key starts with xf_live_.
Check the key hasn't been revoked in Workspace Settings.

Generation takes too long

Image generation typically takes 5-30 seconds depending on the model.
z-image is the fastest model (2-5 seconds).
gemini-pro at 4K can take up to 60 seconds.

API Access — create and manage API keys
Skills — reusable instruction sets for AI agents
Skills Hub — browse, clone, and publish skills
Credits System — understand credit costs

What is MCP?​

Prerequisites​

Generate an API Key​

Setup by Client​

Claude.ai (Web and Mobile)​

Claude Code​

Claude Desktop​

Cursor​

Windsurf / VS Code​

Available Tools​

Workspace and Assets​

Image Generation​

Video Generation​

Audio and Voice​

Image Processing (AI Suite)​

Workflow Management​

Skills​

Monday.com​

Usage Examples​

Check your workspace​

Generate images​

Build and run a workflow​

Use a template​

Troubleshooting​

No tools showing up​

UNAUTHORIZED errors​

Generation takes too long​

Related Pages​