Atlas Cloud MCP Server

English | 中文 | 日本語 | 한국어 | Español | Français

Use Atlas Cloud's 300+ image / video / LLM models in Claude Code, Codex, Gemini CLI, Cursor, Cline and more. Generate images, videos & chat via standard MCP tools.

→ Get your free Atlas Cloud API key · 300+ models · OpenAI-compatible

Supported Models

🎬 Video (170) — Seedance 2.0 Mini · HappyHorse-1.1 · Gemini Omni Flash · Avatar Omni Human 1.5 · Kling V3.0 Turbo · Kling Video O3 4K
🎨 Image (99) — Seedream v5.0 Pro · Nano Banana 2 Lite · MAI-Image-2.5-Flash · MAI-Image-2.5
🧊 3D (5) — Seed3D 2.0 · Hunyuan 3D Rapid · Hunyuan 3D Pro
💬 LLM (59) — Grok 4.5 · Kimi K3 · KAT Coder Pro V2.5 · KAT Coder Air V2.5
🔊 Audio (TTS · Music · ASR) (19) — Seed Audio 1.0 · xAI TTS v1 · ElevenLabs v3 · Gemini 3.1 Flash TTS
📚 Explore more — all 374 live models »

What You Can Do

Ask your AI assistant in plain language — it discovers the right model, builds the parameters, and submits the job:

🎨 "Make a hero image for this blog post" — text-to-image across Nano Banana Pro, GPT Image 2, Flux 2, Seedream, Imagen…
🎬 "Turn this product photo into a 5-second ad" — image-to-video with Kling 3, Seedance 2, Veo 3.1, Sora 2…
🧊 "Make a 3D model from this photo" — image-to-3D / text-to-3D with Hunyuan 3D (GLB/OBJ/USDZ output)
🔊 "Read this script aloud" — text-to-speech with Seed Audio, ElevenLabs, xAI TTS
🎵 "Write a theme song for my app" — music generation with Suno, MiniMax Music
📝 "Transcribe this meeting recording" — speech-to-text with Seed ASR, xAI STT
🎞️ "Storyboard this script into 6 shots" — chain LLM → image → video inside one conversation
✏️ "Edit this image — add a hat" — upload a local file, then run an image-editing model
💸 "How much credit is left, and what did I spend this month?" — check balance, usage, and cost breakdowns
💬 "Summarize this PDF with DeepSeek" — OpenAI-compatible LLM chat with Claude, GPT, DeepSeek, Qwen, GLM…

Under the hood: model discovery, dynamic per-model parameter schemas (validated before every request so invalid params fail fast without spending credits), media upload, one-step quick-generate, account balance & usage, and documentation search — all exposed as standard MCP tools (see Available Tools).

Quick Start

Prerequisites

Node.js >= 18
Atlas Cloud API Key — Get one free at atlascloud.ai

See .env.example for the environment variable to set.

CLI agents (one-line install)

The fastest path — these AI coding agents add the server with a single command:

# Claude Code
claude mcp add atlascloud -- npx -y atlascloud-mcp

# OpenAI Codex CLI
codex mcp add atlascloud -- npx -y atlascloud-mcp

# Gemini CLI
gemini mcp add atlascloud -- npx -y atlascloud-mcp

# Goose CLI
goose mcp add atlascloud -- npx -y atlascloud-mcp

Set the ATLASCLOUD_API_KEY environment variable in your shell first.

IDEs, editors & extensions (JSON config)

Add this to your client's MCP configuration — works with every MCP-compatible client:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Client	Where to add it
Cursor	Settings → MCP → Add Server
Cline	MCP Marketplace → Add Server
Continue	`config.yaml` → MCP
Windsurf	Settings → MCP → Add Server
VS Code (Copilot)	`.vscode/mcp.json` or Settings → MCP
Trae	Settings → MCP → Add Server
JetBrains IDEs	Settings → Tools → AI Assistant → MCP
ChatGPT Desktop	Settings → MCP
Amazon Q Developer	MCP Configuration
Roo Code	Settings → MCP → Add Server

Prefer Skills?

If you'd rather use Skills than MCP, we also ship an Atlas Cloud Skills package for Claude Code and other skill-compatible agents.

Available Tools

Tool	Description
`atlas_search_docs`	Search Atlas Cloud documentation and models by keyword
`atlas_list_models`	List all available models, optionally filtered by type (Text/Image/Video/Audio)
`atlas_get_model_info`	Get detailed model info including API schema, parameters, and usage examples
`atlas_generate_image`	Generate images and 3D models (image-to-3D / text-to-3D) with any supported Image model
`atlas_generate_video`	Generate videos with any supported video model
`atlas_generate_audio`	Generate audio — speech (TTS) and music/songs (Suno, MiniMax Music) — with any supported audio model
`atlas_transcribe_audio`	Transcribe speech to text (ASR) — meetings, interviews, voice notes
`atlas_quick_generate`	One-step image/video/audio generation — auto-finds model by keyword, builds params, and submits
`atlas_upload_media`	Upload local files to get a URL for use with image-edit / image-to-video models
`atlas_chat`	Chat with LLM models (OpenAI-compatible format)
`atlas_get_prediction`	Check status and result of image/video/audio/3D generation tasks
`atlas_get_balance`	Get the account balance and credit summary for your API key
`atlas_get_model_usage`	Get daily model usage (requests, tokens, image/video counts) over a date range
`atlas_get_model_costs`	Get daily model cost (spend) buckets over a date range

Usage Examples

Search for models

"Search Atlas Cloud for video generation models"

Your AI assistant will use atlas_search_docs or atlas_list_models to find relevant models.

Generate an image

"Generate an image of a cat in space using Seedream"

The assistant will:

Use atlas_list_models to find Seedream image models
Use atlas_get_model_info to get the model's parameters
Use atlas_generate_image with the correct parameters

Generate a video

"Create a video of a rocket launch using Kling v3"

The assistant will:

Find the Kling video model
Get its schema to understand required parameters
Use atlas_generate_video with appropriate parameters

Upload a local image for editing or video generation

"Edit this image /Users/me/photos/cat.jpg to add a hat"

The assistant will:

Use atlas_upload_media to upload the local file and get a URL
Find an image-editing model
Use atlas_generate_image with the uploaded URL

Note: Uploaded files are for temporary use with Atlas Cloud generation tasks only. Files may be cleaned up periodically. Do not use this as permanent file hosting — abuse may result in API key suspension.

Generate speech (TTS)

"Read this sentence aloud with Seed Audio: Welcome to Atlas Cloud"

The assistant will:

Use atlas_list_models with type="Audio" to find the TTS model
Use atlas_generate_audio with the text to synthesize
Use atlas_get_prediction to retrieve the generated audio URL

Generate music

"Make a 30-second upbeat synthwave track for my product demo with Suno"

Music models (Suno Chirp, MiniMax Music) are Audio-type models, so the assistant uses atlas_generate_audio with a song description (and optionally lyrics), then retrieves the audio URL via atlas_get_prediction.

Transcribe audio (speech-to-text)

"Transcribe this interview recording: https://example.com/interview.mp3"

The assistant uses atlas_transcribe_audio with a speech-to-text model (e.g., bytedance/seed-asr-2.0) and the audio_url, then retrieves the transcript via atlas_get_prediction. For local files, it first calls atlas_upload_media to get a URL.

Generate a 3D model

"Turn this product photo into a 3D model with Hunyuan 3D"

3D models are Image-type models, so the assistant uses atlas_generate_image with the image parameter and retrieves a GLB/OBJ/USDZ file via atlas_get_prediction.

Chat with an LLM

"Ask Qwen to explain quantum computing"

The assistant will use atlas_chat with the Qwen model.

Check balance and usage

"How much Atlas Cloud credit do I have left, and what did I spend this month?"

The assistant will use atlas_get_balance for the current balance and atlas_get_model_costs for the spend breakdown.

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

More Atlas Cloud Tools

🧰 Want to use it from the terminal? → atlascloud-cli
🤖 Want to use it in Claude Code / Cursor? → Atlas Cloud MCP Server
🎬 Want it as a Claude Code / Codex / Gemini CLI Skill? → atlas-cloud-skills
🎨 ComfyUI nodes → atlascloud_comfyui
🔁 n8n nodes → n8n-nodes-atlascloud
💬 Join our Discord → discord.gg/MWmMr4q9es
🌐 Website → atlascloud.ai

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.github/workflows		.github/workflows
docs		docs
src		src
.env.example		.env.example
.gitignore		.gitignore
.npmignore		.npmignore
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Atlas Cloud MCP Server

Supported Models

Contents

What You Can Do

Quick Start

Prerequisites

CLI agents (one-line install)

IDEs, editors & extensions (JSON config)

Prefer Skills?

Available Tools

Usage Examples

Search for models

Generate an image

Generate a video

Upload a local image for editing or video generation

Generate speech (TTS)

Generate music

Transcribe audio (speech-to-text)

Generate a 3D model

Chat with an LLM

Check balance and usage

Development

More Atlas Cloud Tools

License

About

Releases

Packages

Contributors

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Atlas Cloud MCP Server

Supported Models

Contents

What You Can Do

Quick Start

Prerequisites

CLI agents (one-line install)

IDEs, editors & extensions (JSON config)

Prefer Skills?

Available Tools

Usage Examples

Search for models

Generate an image

Generate a video

Upload a local image for editing or video generation

Generate speech (TTS)

Generate music

Transcribe audio (speech-to-text)

Generate a 3D model

Chat with an LLM

Check balance and usage

Development

More Atlas Cloud Tools

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages