ideagram

Ideogram MCP Server exposes the Ideogram API via MCP, letting Claude Desktop and other MCP clients generate images, reference styles, apply magic prompts, and control aspect ratios through a unified MCP tool set. The server centers on the generate_image tool, which accepts options such as prompt, aspect_ratio, resolution, seed, magic_prompt, rendering_speed, style_codes, style_type, negative_prompt, num_images, and style_reference. With the Ideogram 3.0 integration, you can leverage reference images and style codes for consistent visuals. To use it, configure your MCP client to point at the ideogram server and provide your API key via IDEOGRAM_API_KEY. Once connected, you can call generate_image with a structured argument bundle and receive generated images according to your specified parameters.

Prerequisites:

• Node.js (LTS version recommended) and npm installed on your machine
• Internet access to fetch the MCP server package

Option A: Run via npx (recommended for quick start)

1. Ensure you have an API key for Ideogram: IDEOGRAM_API_KEY
2. In your MCP client config, add: { "mcpServers": { "ideogram": { "command": "npx", "args": ["@sunwood-ai-labs/ideogram-mcp-server"], "env": { "IDEOGRAM_API_KEY": "your_api_key_here" } } } }

Option B: Install locally and run (alternative)

1. Install the MCP server package locally: npm install --save-dev @sunwood-ai-labs/ideagram-mcp-server
2. Run the server via a local script or direct node execution as documented by the package (check package.json for available run scripts).
3. Ensure IDEOGRAM_API_KEY is set in your environment or in your MCP config under env.

Notes:

• The exact start command may vary slightly depending on your environment; refer to the package’s README for any environment-specific notes.

Tips and notes:

• Always keep IDEOGRAM_API_KEY secure and avoid committing it to version control.
• The server supports multiple MCP parameters for generate_image; experiment with aspect_ratio, style_reference, and blur_mask to achieve different results.
• If generating multiple images, you can adjust num_images (1–8) accordingly.
• Ensure network access to Ideogram API endpoints if your configuration requires external calls.
• If you encounter incompatibilities, verify that your Node.js version matches the package requirements and that the MCP client is compatible with the server’s API version (Ideogram v3.0).
• The default image naming uses ideogram-image as the base filename; you can override via base_filename in your tool arguments if supported.