Skip to main content
Describes the deAPI MCP server, its available tools, and how to connect agents or IDE integrations to use deAPI as a structured toolbox.
Alpha Release — The MCP server is currently in alpha. You may encounter occasional issues or unexpected behavior as we continue to refine the service. We actively welcome feedback and bug reports — join the conversation on Discord.
In addition to the HTTP API, deAPI exposes an MCP (Model Context Protocol) server. This allows AI assistants, IDE extensions, and MCP-aware tools to call deAPI capabilities as structured tools instead of manually constructing HTTP requests.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI models and agents to interact with external tools and services in a structured way. Instead of crafting raw HTTP requests, your AI assistant discovers available tools and calls them using a standardized protocol. With deAPI’s MCP server, Claude, ChatGPT, Cursor, and other MCP-compatible clients can:
  • Generate images, videos, and audio directly within conversations
  • Transcribe YouTube videos or audio files
  • Remove backgrounds and upscale images
  • Check pricing before running expensive operations
  • Access all deAPI capabilities through natural language
New tools and capabilities will be added as the MCP server evolves. Follow our Discord for updates and to share feature requests.

Server Details

PropertyValue
MCP Server URLhttps://mcp.deapi.ai/mcp
OAuth Client IDdeapi-mcp
OAuth Client SecretYour deAPI API key
TransportStreamed HTTP

Available Tools

The deAPI MCP server exposes the following tools:

Image Generation & Manipulation

ToolDescription
text_to_imageGenerate images from text prompts using AI diffusion models (Flux, Z-Image-Turbo)
image_to_imageTransform existing images using text prompts (style transfer, editing)
image_to_textExtract text from images using OCR
image_remove_backgroundRemove background from images (transparent PNG output)
image_upscaleUpscale images to higher resolution
text_to_image_priceCalculate price for text-to-image generation
image_to_image_priceCalculate price for image transformation
image_to_text_priceCalculate price for OCR extraction
image_remove_background_priceCalculate price for background removal
image_upscale_priceCalculate price for image upscaling

Video Generation & Processing

ToolDescription
text_to_videoGenerate videos from text prompts
image_to_videoAnimate static images into videos
video_file_transcriptionTranscribe uploaded video files to text
video_url_transcriptionTranscribe videos from URLs (YouTube, X/Twitter, Twitch, Kick)
video_file_transcription_priceCalculate price for video file transcription
video_url_transcription_priceCalculate price for video URL transcription

Audio & Speech

ToolDescription
text_to_audioConvert text to natural-sounding speech (TTS)
audio_transcriptionTranscribe uploaded audio files to text using Whisper
audio_url_transcriptionTranscribe audio from URLs (X/Twitter Spaces)
audio_transcription_priceCalculate price for audio file transcription
audio_url_transcription_priceCalculate price for audio URL transcription

Utility

ToolDescription
get_available_modelsList all available AI models with specifications
get_balanceCheck your deAPI account balance
check_job_statusCheck status of submitted jobs

How to Connect

Claude (claude.ai)

To use deAPI MCP tools directly in Claude conversations: Step 1. Get your API key from the deAPI Dashboard Step 2. Add the MCP connector in Claude settings:
  • Go to SettingsConnectors
  • Click Add Connector or Add MCP Server
  • Select New OAuth Connector
  • Enter the following credentials:
FieldValue
OAuth Client IDdeapi-mcp
OAuth Client SecretYour deAPI API key
Server URLhttps://mcp.deapi.ai/mcp
Step 3. Grant permissions — After adding the connector, Claude will ask you to authorize the connection. Click Allow to enable deAPI MCP tools in your conversations. Step 4. Start using deAPI MCP by asking Claude to generate images, transcribe videos, or use any other capability. Make sure to mention “deAPI MCP” in your prompt so Claude knows to use the MCP tools. Example prompts:
  • “Using deAPI MCP, generate an image of a futuristic city at sunset”
  • “With deAPI MCP, transcribe this YouTube video: [URL]”
  • “With deAPI MCP, transcribe this Twitch video: [URL]”
  • “Check my deAPI MCP balance”
  • “Using deAPI MCP, create a video of waves crashing on a beach”

Cursor IDE

To integrate deAPI MCP into Cursor for AI-assisted development: Step 1. Get your API key from the deAPI Dashboard Step 2. Open Cursor Settings:
  • Press Cmd/Ctrl + Shift + P
  • Search for “Cursor Settings” or navigate to SettingsCursor Settings
Step 3. Add MCP Configuration:
  • Find the MCP or Model Context Protocol section
  • Add a custom MCP server configuration
  • Paste the following JSON (replace YOUR_API_KEY with your actual key):
{
  "mcpServers": {
    "deapi": {
      "name": "DEAPI MCP",
      "url": "https://mcp.deapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Step 4. Restart Cursor to apply the configuration. Step 5. Invoke deAPI MCP in chat by using phrases like:
  • “Using deAPI MCP, generate an image of…”
  • “With deAPI MCP, transcribe this audio…”
  • “Via deAPI MCP, check my balance”
Tip: Cursor recognizes deAPI MCP tools when you mention keywords like “using deAPI MCP”, “with deAPI MCP”, or “via MCP” in your prompts.

ChatGPT

To use deAPI MCP tools in ChatGPT conversations:
Availability: MCP is available in beta to Pro, Plus, Business, Enterprise, and Education accounts. The MCP apps work on both web and desktop, but Developer mode settings are only accessible in the web version at chatgpt.com.
Step 1. Get your API key from the deAPI Dashboard Step 2. Enable Developer mode:
  • Go to SettingsApps & Connectors
  • Scroll to Advanced settings at the bottom
  • Enable Developer mode
  • Go back — a Create App button will appear next to Advanced settings
Step 3. Create a new MCP App:
  • Click Create App
  • Fill in the following details:
FieldValue
NamedeAPI (or any name you prefer)
DescriptiondeAPI MCP (optional)
MCP Server URLhttps://mcp.deapi.ai/mcp
AuthenticationOAuth
OAuth Client IDdeapi-mcp
OAuth Client SecretYour deAPI API key
Step 4. Check the risk acknowledgment checkbox (“I understand and want to continue”) Step 5. Click Create Step 6. Start using deAPI MCP by asking ChatGPT to generate images, transcribe videos, or use any other capability. Example prompts:
  • “Using deAPI MCP, generate an image of a cyberpunk cat”
  • “With deAPI MCP, transcribe this YouTube video: [URL]”
  • “Check my deAPI MCP balance”
  • “With deAPI MCP, transcribe this Kick video: [URL]“

Supported Models

The MCP server provides access to all deAPI models:

Text-to-Image

  • Flux.1 schnell — Fast, high-quality image generation
  • Z-Image-Turbo INT8 — Optimized turbo model for quick and realistic generations

Text-to-Speech

  • Kokoro — Natural TTS with multiple voices and languages

Video Generation

  • LTX-Video-0.9.8 13B — Text-to-video and image-to-video generation

Image Processing

  • QwenImageEditPlus4Bit — Advanced image-to-image transformation
  • Ben2 — Background removal

Transcription

  • Whisper Large V3 — State-of-the-art speech recognition

OCR

  • Nanonets Ocr S — Text extraction from images

Embeddings

  • BGE M3 — Text embeddings
Use get_available_models tool to retrieve the full list with current specifications and limits.

Usage Examples

Generate an Image

Ask your AI assistant:
“Using deAPI MCP, generate an image of an astronaut riding a horse on Mars, photorealistic style”
The assistant will call text_to_image with appropriate parameters and return the generated image URL.

Transcribe a YouTube Video

“With deAPI MCP, transcribe this YouTube video with timestamps: https://www.youtube.com/watch?v=7qaiNfoMRts
The assistant calls video_url_transcription and returns the full transcript.

Convert Text to Speech

“Using deAPI MCP, convert this text to speech with a British female voice: ‘Welcome to our platform’”
The assistant calls text_to_audio with the Kokoro model and appropriate voice settings.

Remove Background from Image

“Using deAPI MCP, remove the background from this product photo”
The assistant calls image_remove_background and returns a transparent PNG.

Transcribe X/Twitter Spaces

“With deAPI MCP, transcribe this Twitter Space: https://twitter.com/i/spaces/…”
The assistant calls audio_url_transcription and returns the full transcript.

When to Use MCP vs HTTP API

Use CaseRecommended
AI assistants & chatbotsMCP Server
IDE integrations (Cursor, VS Code)MCP Server
Backend services & workersHTTP API
Batch processingHTTP API
Direct programmatic controlHTTP API
Agent-driven workflowsMCP Server
Use the MCP server when you want an AI agent to decide which tools to call, with which parameters, and in what order. Use the HTTP API + queue for typical backend integrations where you directly manage requests and results.

Troubleshooting

Connection Issues

  • Verify your API key is valid and has sufficient balance
  • Check the server URL is exactly https://mcp.deapi.ai/mcp
  • For Claude: Ensure OAuth Client ID is deapi-mcp and Secret is your API key
  • For Cursor: Ensure Bearer token format — the Authorization header should be Bearer YOUR_API_KEY

Tools Not Appearing

  • Restart your MCP client (Claude, ChatGPT, Cursor) after configuration changes
  • In Claude: Make sure you clicked Allow when prompted to grant permissions
  • In ChatGPT: Ensure Developer mode is enabled in Advanced settings
  • Verify JSON syntax in configuration files (Cursor)
  • Check that your API key has the necessary permissions

Jobs Stuck in Processing

  • Use check_job_status tool with the job ID to monitor progress
  • Large video generation or transcription jobs may take several minutes
  • Check status.deapi.ai for system status