Magnific API Docs

Magnific MCP (Model Context Protocol) ​

Integrate Magnific into your AI workflows ​

Connect AI assistants like Claude, Cursor and more with the Magnific API

View on GitHub

What is Magnific MCP? ​

Magnific MCP is a server that implements the Model Context Protocol (MCP) to connect AI assistants with the Magnific API. It enables assistants to search, download, and generate images and icons, manage resources, and use AI-powered image classification tools.

Remote Version (Beta) ​

For an even simpler experience, we offer a remote beta version available at api.magnific.com/mcp that you can use directly with your Magnific API key. No installation required!

This version uses the HTTP-stream protocol to communicate with the remote MCP server.

Remote Version Benefits ​

  • No Installation: Immediate access without local setup
  • Always Updated: Automatic access to the latest features
  • Easy Configuration: Only need your API key
  • Zero Maintenance: We handle everything for you
  • HTTP-stream Protocol: Secure communication over HTTPS

Configuration for MCP Clients ​

Add the MCP configuration below to your MCP client configuration file.

Cursor

  1. Open full Cursor settings 2. Navigate to the "MCP" tab 3. Click "Add new global MCP server" 4. Add the server config below 5. Click the refresh button next to the "browsermcp" server to reload the server config

    For more information, see Cursor's MCP documentation.

Claude Desktop

See Claude's MCP documentation

WARNING

Claude Desktop currently has a bug where MCP servers are started twice. This will cause Claude to show an error when using the Browser MCP server but it will still work.

Windsurf

See Windsurf's MCP documentation

VS Code

See VS Code's MCP documentation

Server configuration ​

json
    "mcpServers": {
        "magnific": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://api.magnific.com/mcp",
                "--header",
                "x-magnific-api-key:${MAGNIFIC_API_KEY}"
            ],
            "env": {
                "MAGNIFIC_API_KEY": "your_api_key_here"
            }
        }
    }
}

Open Source Version ​

The Magnific MCP project is available as open source on GitHub, providing full transparency and customization.

This version uses the stdio protocol for local communication between your MCP client and the server.

Key Features ​

  • Open Source: Fully transparent and customizable to your needs
  • Easy Installation: Simple setup with modern tools like uv
  • Native Integration: Compatible with Claude Desktop, Cursor, and other MCP clients
  • Full Functionality: Access to all Magnific API capabilities
  • Stdio Protocol: Direct local communication for maximum performance

Installation ​

bash
# Clone the repository
git clone https://github.com/freepik-company/freepik-mcp.git
cd magnific-mcp

# Install dependencies with uv
uv sync

# Configure your API key
export MAGNIFIC_API_KEY="your_api_key_here"

Configuration for Claude Desktop, Cursor & Other MCP Clients ​

Add this configuration to your MCP client configuration file:

json
    "mcpServers": {
        "magnific-mcp": {
            "command": "uv",
            "args": ["run", "--directory", "/path/to/magnific-mcp", "main.py"],
            "env": {
                "MAGNIFIC_API_KEY": "your_api_key_here"
            }
        }
    }
}

Getting Started with MCP ​

Support and Contributions ​

[/>

    Documentation](https://github.com/freepik-company/freepik-mcp/wiki)

[/>

    Issues](https://github.com/freepik-company/freepik-mcp/issues)

[/>

    Contributions](https://github.com/freepik-company/freepik-mcp)

/>

    MIT License

Have questions or need help? Don't hesitate to open an issue on our GitHub repository or contact our support team.