Freepik Seedream

This MCP server integrates Freepik Seedream, Freepik Stock, and Mystic AI capabilities to let you generate and edit images, search stock resources, and manage legacy Mystic generation from a single, deployable MCP endpoint. It is optimized for Smithery deployment and supports both remote hosting and local development workflows.

How to use

You can generate images from text, edit images with natural language, and check the status of ongoing tasks using Seedream 4.0. You can search for stock photos, vectors, and PSDs, retrieve resource details, and obtain download URLs with Freepik Stock endpoints. If you work with legacy integration, Mystic AI generation is also available. To start using the server, connect your MCP client to the deployed MCP URL or run the local MCP server, then call the appropriate endpoints for the feature you need.

How to install

Prerequisites you need before installing: Node.js 18 or later, and a Freepik API Key with a Premium+ subscription to enable Seedream 4 features.

Step-by-step setup for local development and running the MCP server locally:

# Install dependencies
npm install

# Run in dev mode
npm run dev

# Build for production
npm run build

Additional setup and deployment notes

Deployment to Smithery provides a ready-to-use MCP URL once you push your code and deploy. You can also connect a custom MCP client by adding a connector that points to this Smithery URL, and authenticate with your Freepik API Key to access Seedream features.

Configuration and endpoints

The server exposes endpoints for the following features. Use these endpoints through your MCP client by referencing the corresponding tool names and actions.

Usage examples

Generate an image: Use a seedream_generate request with your prompt like: Generate a cyberpunk city at night with neon lights.

Security and keys

Keep your Freepik API Key secure. Do not expose it in client-side code or public repositories. Use environment variables or secret management provided by your deployment platform to inject the API key at runtime.

Troubleshooting

If you encounter issues with deployment, verify that your Smithery URL is accessible, your Freepik API Key is valid, and the environment has Node.js 18+ installed. Check that dependencies are installed with npm install and that the dev server is running with npm run dev during local development.

Available tools

seedream_generate

Generate images from text prompts using Seedream 4.0 with support for up to 4K resolution.

seedream_edit

Edit images with natural language instructions using Seedream 4.0.

seedream_status

Check the status of ongoing Seedream generation tasks.

search_resources

Search Freepik stock resources including photos, vectors, and PSDs.

get_resource

Retrieve detailed information about a specific resource.

download_resource

Obtain download URLs for Freepik stock resources.

mystic_generate

Generate images using the legacy Mystic AI endpoint.