Skip to main content
Glama

Freepik MCP Server

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
A
license - permissive license
-
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

                  • -
                    security
                    F
                    license
                    -
                    quality
                    A MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.
                    Last updated -
                    79
                    TypeScript
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A collection of custom MCP servers providing various AI-powered capabilities including web search, YouTube video analysis, GitHub repository analysis, reasoning, code generation/execution, and web crawling.
                    Last updated -
                    2
                    Python
                    MIT License
                  • A
                    security
                    A
                    license
                    A
                    quality
                    An MCP server that enables AI applications to access 20+ model providers (including OpenAI, Anthropic, Google) through a unified interface for text and image generation.
                    Last updated -
                    2
                    10
                    Python
                    MIT License
                  • -
                    security
                    F
                    license
                    -
                    quality
                    An MCP server that allows agents to interact with Meilisearch, a powerful open-source search engine, through its API using natural language.
                    Last updated -
                    Python

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/MCERQUA/freepik-mcp'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server