Freepik FastMCP Toolkit

🚀 MCP Server for seamless Freepik API integration

🎯 What is this?

A Model Context Protocol (MCP) server that connects your AI assistants (Claude, Cursor, etc.) directly with Freepik's powerful APIs. Generate, search, and manage visual content without leaving your AI workflow.

🛠️ What tools are available?

🎨 Icon Search & Download - Find and download icons in multiple formats
📁 Resource Management - Access and manage multimedia content
🤖 AI Image Classification - Automatically classify and analyze images
🖼️ Image Generation - Create custom images using Mystic AI

📋 Prerequisites

Before you start, make sure you have:

Python 3.12+ installed
uv dependency manager (install here)
Freepik API Key (get yours here)

🚀 Installation

1. Clone and navigate

git clone <REPOSITORY_URL>
cd freepik-toolkit/fastmcp

2. Install using Makefile

# Install dependencies
make install

# Verify installation
make version

3. Configure your API Key

echo "FREEPIK_API_KEY=your_api_key_here" > .env

💡 Get your API Key at: freepik.com/api

⚙️ Configuration for AI Assistants

For Claude Desktop or Cursor on Linux

Add this to your config.json file:

⚠️ For Windows users: If you're on Windows, you need to use WSL (Windows Subsystem for Linux) to run this MCP server.

{
  "mcpServers": {
    "freepik-fastmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory", 
        "/FULL/PATH/TO/freepik-mcp",
        "fastmcp",
        "run",
        "main.py"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

🔧 Important Configuration Steps

Find your full path:
pwd # Copy the output and replace /FULL/PATH/TO/ in the config
Replace with your API key:
- Get it from freepik.com/api
- Replace your_actual_api_key_here

🏃‍♂️ Quick Start

# Development mode (auto-reload)
make dev

# Production mode  
make run

# Check code quality
make lint

# Format code
make format

# Clean temporary files
make clean

# See all commands
make help

🤝 Contributing

We welcome contributions! Please follow these guidelines:

📝 Commit Convention

This project uses Conventional Commits. Format your commits as:

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

Types:

feat: New feature
fix: Bug fix
docs: Documentation changes
style: Code style changes (formatting, etc.)
refactor: Code refactoring
test: Adding or updating tests
chore: Maintenance tasks

Examples:

feat(icons): add search filtering by category
fix(api): resolve authentication timeout issue  
docs(readme): update installation instructions
refactor(mystic): improve error handling logic

🔄 Contribution Workflow

Fork the repository
Create a feature branch: git checkout -b feat/amazing-feature
Commit using conventional format: git commit -m "feat: add amazing feature"
Push to your branch: git push origin feat/amazing-feature
Open a Pull Request

📚 Development Commands

Command	Description
`make help`	Show all available commands
`make install`	Install dependencies
`make dev`	Run in development mode
`make run`	Run in production mode
`make lint`	Check code quality
`make format`	Format code automatically
`make clean`	Clean temporary files
`make version`	Check FastMCP version

🛡️ Security

⚠️ Never commit your API Key
✅ Use .env files for sensitive data
✅ The .env file is in .gitignore

📖 API Documentation

For detailed API information:

Freepik API Documentation

🆘 Troubleshooting

Common issues:

"Command not found" → Install uv dependency manager
"Invalid API Key" → Check your key at freepik.com/api
"Path not found" → Verify the full path in your config
"Connection refused" → Make sure the server is running with make dev

Still having issues? Open an issue on GitHub with:

Your OS and Python version
Full error message
Configuration file (without API key)

Ready to create amazing content with AI? 🎨✨

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

Tools

View all tools

A Model Context Protocol (MCP) server that connects AI assistants directly with Freepik's APIs, allowing users to search, generate, and manage visual content without leaving their AI workflow.

Related MCP Servers

Freepik MCP Server
MCERQUA
-
security
F
license
-
quality
An MCP server implementation that enables users to search, download Freepik resources, and generate images using Mystic AI through natural language requests.
Last updated -
JavaScript
AgentModeofficial
agentmode
A
security
F
license
A
quality
An all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.
Last updated -
2
Python
Paws-on-MCP
hemanth
-
security
F
license
-
quality
A comprehensive Model Context Protocol (MCP) server implementing the latest MCP specification with tools, resources, prompts, and enhanced sampling capabilities that features HackerNews and GitHub API integrations for AI-powered analysis.
Last updated -
319
Python
Google Research MCP
mixelpixx
-
security
A
license
-
quality
Model Context Protocol (MCP) server that provides AI assistants with advanced web research capabilities, including Google search integration, intelligent content extraction, and multi-source synthesis.
Last updated -
35
TypeScript
MIT License

View all related MCP servers

Freepik FastMCP Toolkit