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 — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7

• 🎨 Image — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5

• 🧊 3D — Hunyuan 3D image-to-3D / text-to-3D

• 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen

• 🔊 Audio (TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs

• 📚 Explore more — 300+ models »

Contents

• What You Can Do
• Quick Start
• Available Tools
• Usage Examples
• Development
• More Atlas Cloud Tools
• License

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
• 🎞️ "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) with any supported audio model
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:

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

Generate a video

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

The assistant will:

1. Find the Kling video model
2. Get its schema to understand required parameters
3. 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:

1. Use atlas_upload_media to upload the local file and get a URL
2. Find an image-editing model
3. 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:

1. Use atlas_list_models with type="Audio" to find the TTS model
2. Use atlas_generate_audio with the text to synthesize
3. Use atlas_get_prediction to retrieve the generated audio 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