Freepik MCP Server

Integrations

  • Enables searching, retrieving, and downloading stock resources (photos, vectors, PSDs) from Freepik's API, as well as generating custom images using Freepik's Mystic AI image generation capabilities.

Freepik MCP Server

An MCP server implementation for interacting with Freepik's API, providing access to stock photos and Mystic AI image generation capabilities.

Features

  • Search Freepik resources (photos, vectors, PSDs)
  • Get detailed resource information
  • Download resources
  • Generate images using Mystic AI
  • Check image generation status

Prerequisites

Installation

# Create a new directory for your MCP servers mkdir mcp-servers cd mcp-servers # Clone the repository git clone https://github.com/MCERQUA/freepik-mcp.git cd freepik-mcp # Install dependencies npm install # Build the server npm run build

Configuration

  1. First, obtain your Freepik API key by following the instructions in API_SETUP.md
  2. Add the server to your MCP settings file:
{ "mcpServers": { "freepik": { "command": "node", "args": ["path/to/freepik-mcp/build/index.js"], "env": { "FREEPIK_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": [] } } }

Available Tools

search_resources

Search for Freepik resources with various filters:

{ term?: string; // Search term limit?: number; // Results per page order?: 'relevance' | 'recent'; filters?: { orientation?: { landscape?: boolean; portrait?: boolean; square?: boolean; panoramic?: boolean; }; content_type?: { photo?: boolean; psd?: boolean; vector?: boolean; }; license?: { freemium?: boolean; premium?: boolean; }; }; }

get_resource

Get detailed information about a specific resource:

{ id: number; // Resource ID to get details for }

download_resource

Get download URL for a specific resource:

{ id: number; // Resource ID to download }

generate_image

Generate an image using Freepik Mystic AI:

{ prompt: string; // Text description of the image to generate resolution?: '2k' | '4k'; aspect_ratio?: 'square_1_1' | 'classic_4_3' | 'traditional_3_4' | 'widescreen_16_9' | 'social_story_9_16'; realism?: boolean; // Enable realistic style engine?: 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle'; creative_detailing?: number; // 0-100 }

check_status

Check the status of a Mystic image generation task:

{ task_id: string; // ID of the generation task to check }

Development

# Install dependencies npm install # Build the server npm run build # Run in development mode npm run dev

Error Handling

The server implements comprehensive error handling:

  • API errors are logged with detailed information
  • Input validation using Zod schemas
  • Proper error responses with context
  • Rate limiting awareness

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server implementation that enables users to search, download Freepik resources, and generate images using Mystic AI through natural language requests.

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Available Tools
            1. search_resources
            2. get_resource
            3. download_resource
            4. generate_image
            5. check_status
          2. Development
            1. Error Handling
              1. Contributing
                1. License

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    A MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.
                    Last updated -
                    1
                    2
                    TypeScript
                    MIT License
                    • Apple
                    • Linux
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A MCP server that integrates with Cursor IDE to generate images based on text descriptions using JiMeng AI, allowing users to create and save custom images directly within their development environment.
                    Last updated -
                    82
                    Python
                    MIT License
                    • Apple
                    • Linux
                  • A
                    security
                    A
                    license
                    A
                    quality
                    An MCP Server that integrates with Stability AI's API to provide high-quality image generation, editing, and manipulation capabilities including background removal, outpainting, search-and-replace, and upscaling.
                    Last updated -
                    13
                    35
                    55
                    TypeScript
                    MIT License
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    An MCP server that connects to Pollinations.ai API, enabling AI models to generate and download images and text through natural language commands.
                    Last updated -
                    2
                    JavaScript
                    Apache 2.0
                    • Apple
                    • Linux

                  View all related MCP servers

                  ID: rdaoj2cr8o