MCP Integration Guide

What is MCP?

MCP (Model Context Protocol) is an open protocol by Anthropic that lets AI assistants connect to external tools. With xPilot's MCP server, you can generate images, videos, and social media posts directly from Claude Desktop, Claude Code, or any MCP-compatible client.

Available Tools

ToolDescription
list_modelsList all 49 AI models (13 free), grouped by text/image/video
generate_imageGenerate AI images with FLUX, Seedream, and more (free models available)
generate_videoGenerate AI videos — text-to-video and image-to-video (Seedance, Wan, Kling)
generate_postGenerate engaging social media posts for X (Twitter)
check_taskCheck the status of image/video generation tasks
1

Get Your API Key

Prerequisites

  1. Sign up or log in to xPilot at xpilot.jytech.us
  2. Go to Settings → API Keys and click "Create New Key"
  3. Copy your API key (starts with xp_). It will only be shown once.

New accounts come with $5 free credit — enough to try all MCP tools.

2

Connect from Claude Desktop

Add xPilot as an MCP server

Open your Claude Desktop config file and add the xPilot server:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json{
  "mcpServers": {
    "xpilot": {
      "url": "https://xpilot.jytech.us/api/mcp",
      "headers": {
        "Authorization": "Bearer xp_your_api_key_here"
      }
    }
  }
}

Replace xp_your_api_key_here with your actual API key. Restart Claude Desktop after saving.

3

Connect from Claude Code

Add to your Claude Code settings

Add to your Claude Code settings.json (or project .mcp.json):

json{
  "mcpServers": {
    "xpilot": {
      "type": "url",
      "url": "https://xpilot.jytech.us/api/mcp",
      "headers": {
        "Authorization": "Bearer xp_your_api_key_here"
      }
    }
  }
}
4

Usage Examples

Try these prompts in Claude

List Models

What AI models are available on xPilot? Show me the free ones.

Generate Image

Generate an image of a futuristic city skyline at sunset using the free FLUX model.

Generate Video

Create a 5-second video of ocean waves crashing on a rocky shore.

Generate Post

Write a Twitter post about the latest AI trends in marketing, with hashtags.

Server Endpoints

EndpointTypeAuth
https://xpilot.jytech.us/api/mcpNext.jsBearer Token
https://xpilot-mcp.<account>.workers.devCloudflare WorkerBearer Token

Both endpoints support the same MCP tools. The Cloudflare Worker endpoint is edge-deployed globally for faster response times.

Discovery & Standards

xPilot follows standard AI discovery protocols:

  • GET /api/mcpMCP server discovery (tools, resources, transport info)
  • /.well-known/ai-plugin.jsonOpenAI plugin manifest for AI platform discovery
  • /llms.txtPlain-text platform description for LLM crawlers

Troubleshooting

"Invalid or missing API key"

Make sure your API key starts with xp_ and is not revoked. Check Settings → API Keys in xPilot.

Tools not showing in Claude

Restart Claude Desktop after editing the config file. Check that the JSON syntax is valid.

Video task says "Processing..."

Video generation takes 1-5 minutes. Use the check_task tool with the task ID to poll for completion.

Rate limit exceeded

The API allows 30 requests per minute per key. Wait a moment and try again.