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
Related MCP server: Meilisearch MCP Server
Prerequisites
Node.js 18 or higher
A Freepik API key (see API Setup Guide)
Installation
Configuration
First, obtain your Freepik API key by following the instructions in API_SETUP.md
Add the server to your MCP settings file:
Available Tools
search_resources
Search for Freepik resources with various filters:
get_resource
Get detailed information about a specific resource:
download_resource
Get download URL for a specific resource:
generate_image
Generate an image using Freepik Mystic AI:
check_status
Check the status of a Mystic image generation task:
Development
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
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
License
MIT