deAPI Mcp Server

- Complete API Coverage: 39 deAPI tools exposed via MCP, covering every v2 client endpoint
- Smart Adaptive Polling: Automatically polls async jobs with optimized intervals based on job type
- OAuth 2.0 Authentication: Secure token exchange via OAuth Authorization Code flow with PKCE
- Error Recovery: Automatic retry logic with exponential backoff
- Progress Reporting: Real-time progress updates to MCP clients
- Type Safety: Full Pydantic schema validation
- Production Ready: Built with FastMCP framework for reliability

- audio_transcription - Transcribe audio files to text using Whisper models
- audio_transcription_price - Calculate transcription cost
- text_to_audio - Convert text to natural speech (TTS)
- text_to_audio_price - Calculate TTS cost
- text_to_music - Generate music from text description and lyrics
- text_to_music_price - Calculate music generation cost
- audio_url_transcription - Transcribe audio from URLs of completed Twitter Spaces
- audio_url_transcription_price - Calculate Twitter Spaces transcription cost

- video_file_transcription - Transcribe video files to text
- video_file_transcription_price - Calculate video file transcription cost
- video_url_transcription - Transcribe videos from URLs (YouTube, Twitter/X, Twitch, Kick)
- video_url_transcription_price - Calculate video URL transcription cost

- text_to_image - Generate images from text prompts
- image_to_image - Transform images with text guidance
- image_to_text - Extract text from images (OCR)
- image_remove_background - Remove background from images
- image_upscale - Upscale images to higher resolution
- text_to_image_price - Calculate image generation cost
- image_to_image_price - Calculate image transformation cost
- image_to_text_price - Calculate OCR cost
- image_remove_background_price - Calculate background removal cost
- image_upscale_price - Calculate upscaling cost

- text_to_video - Generate videos from text prompts
- image_to_video - Animate static images into videos
- audio_to_video - Generate video conditioned on audio content
- video_replace - Replace a person in a video with a character from a reference image
- video_remove_background - Remove the background from a video
- video_upscale - Upscale a video to higher resolution
- text_to_video_price - Calculate text-to-video cost
- image_to_video_price - Calculate image-to-video cost
- audio_to_video_price - Calculate audio-to-video cost
- video_replace_price - Calculate video character replacement cost
- video_remove_background_price - Calculate video background-removal cost
- video_upscale_price - Calculate video upscaling cost

- text_to_embedding - Generate text embeddings for semantic search
- text_to_embedding_price - Calculate embedding cost

- prompt_booster - Enhance a prompt for any deAPI inference type using AI guides (synchronous, returns refined prompt directly)
- prompt_booster_price - Calculate prompt-enhancement cost

- get_balance - Check account balance
- get_available_models - List available AI models with specifications
- check_job_status - Query async job status by ID

Authentication is handled at the connection level, not per-tool-call. Tools do NOT accept a deapi_api_token parameter.

Here's an example workflow:

1. Get available models:

Use get_available_models to see available models

2. Check your balance:

Use get_balance to check remaining credits

3. Generate an image:

Use text_to_image with:

- prompt: "A beautiful sunset over mountains"

- model: "Flux1schnell"

4. Transcribe audio:

Use audio_transcription with:

- audio: "base64-encoded-audio-or-url"

- include_ts: true

Note: When calling tools via Claude Desktop or MCP SDK, authentication is handled automatically through the server connection (OAuth or HTTP headers). See AUTH.md for detailed OAuth setup.