MCP Server

Use Atlas Cloud AI models directly in your IDE with the official MCP Server. Supports Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI, and more.

What is MCP?

Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI assistants to interact with external tools and data sources in a standardized way. Think of MCP as a universal adapter — it allows AI-powered IDEs like Cursor, Claude Desktop, and Claude Code to seamlessly connect with third-party services, APIs, and data.

By using MCP, developers can extend their AI assistant's capabilities far beyond simple code completion: they can search documentation, generate images, create videos, interact with LLMs, and much more — all through natural language commands within their coding environment.

Atlas Cloud MCP Server

Atlas Cloud provides an official MCP Server (atlascloud-mcp on npm) that brings the full power of Atlas Cloud's AI API platform directly into your IDE. With 300+ AI models available — including image generators, video creators, and large language models — you can access everything without switching between browser tabs or writing API calls manually.

GitHub Repository: AtlasCloudAI/mcp-server

Key Features

Documentation Search — Search Atlas Cloud docs, models, and API references directly from your IDE
Model Discovery — List and explore 300+ available AI models with pricing and capabilities
Image Generation — Generate images using models like Seedream, Qwen-Image, FLUX, etc.
Video Generation — Generate videos using models like Kling, Vidu, Seedance, Wan, etc.
LLM Chat — Chat with LLM models (OpenAI-compatible) including GPT, DeepSeek, Qwen, GLM, etc.
Dynamic Schema — Automatically fetches each model's parameter schema for accurate API usage

Prerequisites

Before setting up the Atlas Cloud MCP Server, make sure you have:

Node.js 18 or higher — Download Node.js
Atlas Cloud API Key — Sign up and get your key at atlascloud.ai

Configuration

Cursor

Open or create the file ~/.cursor/mcp.json and add the following:

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

Restart Cursor to apply the changes.

Claude Desktop

Open the configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the MCP server configuration:

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

Restart Claude Desktop to apply the changes.

Claude Code

Run the following command to add the Atlas Cloud MCP Server:

claude mcp add atlascloud -- npx -y atlascloud-mcp

Then set your API key as an environment variable:

export ATLASCLOUD_API_KEY="your-api-key-here"

To persist the API key across terminal sessions, add the export command to your shell profile (~/.bashrc, ~/.zshrc, etc.).

Windsurf

Add the following to your Windsurf MCP configuration:

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

Codex

Open or create the Codex configuration file ~/.codex/config.toml and add:

[mcp_servers.atlascloud]
command = "npx"
args = ["-y", "atlascloud-mcp"]

[mcp_servers.atlascloud.env]
ATLASCLOUD_API_KEY = "your-api-key-here"

Gemini CLI

Open or create the Gemini settings file ~/.gemini/settings.json and add:

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

Kilo Code

Open or create the project-level config .kilocode/mcp.json and add:

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

OpenCode

Open or create the OpenCode config file opencode.json and add:

{
  "mcp": {
    "atlascloud": {
      "type": "local",
      "command": ["npx", "-y", "atlascloud-mcp"],
      "enabled": true,
      "environment": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

The Atlas Cloud MCP Server provides 7 tools that your AI assistant can use:

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)
`atlas_get_model_info`	Get detailed model info including API schema, parameters, and usage examples
`atlas_generate_image`	Generate images with any supported image model
`atlas_generate_video`	Generate videos with any supported video model
`atlas_chat`	Chat with LLM models (OpenAI-compatible format)
`atlas_get_prediction`	Check status and result of image/video generation tasks

Usage Examples

Once configured, you can interact with Atlas Cloud through natural language:

Search for Models

"Search Atlas Cloud for video generation models"
"List all image generation models with their pricing"
"Show me details about the DeepSeek V3 model"

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

Chat with an LLM

"Ask DeepSeek V3 to explain quantum computing"

The assistant will use atlas_chat with the DeepSeek model.

Troubleshooting

Common Issues

"Command not found" error when running npx

Make sure Node.js 18+ is installed and npx is available in your PATH:

node --version  # Should be 18.x or higher
npx --version   # Should output a version number

"Invalid API Key" error

Verify your API key is correctly set:

echo $ATLASCLOUD_API_KEY  # Should output your key

If empty, set it again and make sure there are no extra spaces or quotes.

MCP Server not showing up in IDE

Make sure you've restarted your IDE after adding the configuration
Double-check the JSON syntax in your configuration file
Verify the configuration file is in the correct location for your IDE

Getting Help

GitHub Issues: AtlasCloudAI/mcp-server/issues
Atlas Cloud Support: Contact us