Higgsfield AI MCP Server

MCP (Model Context Protocol) server for Higgsfield AI API - enabling AI-powered image generation, video creation, and speech synthesis capabilities.

Features

🎨 Text-to-Image (Soul Model)

• Generate high-quality images from text prompts
• Multiple image sizes and quality options
• Custom style presets and character references
• Batch generation support

🎬 Image-to-Video (DOP Model)

• Animate static images with motion presets
• Start and end frame support
• Customizable motion strength

🗣️ Speech-to-Video

• Generate talking head videos
• Custom image and audio input
• Adjustable quality and duration

👤 Character Management

• Create consistent character references
• Use across multiple generations
• Manage character library

📊 Job Management

• Async job status tracking
• Webhook notifications
• Result retrieval

Installation

Prerequisites

• Python 3.10 or higher
• Higgsfield AI API credentials (Get them here)

Install via pip

pip install higgsfield-mcp

Install from source

git clone 
cd higgsfield-mcp
pip install -e .

🚀 Quick Setup for Claude Code

Using Claude Code CLI? See CLAUDE_CODE_SETUP.md for step-by-step instructions.

TL;DR:

1. pip install higgsfield-mcp
2. Add to .mcp.json:

{
  "mcpServers": {
    "higgsfield": {
      "command": "higgsfield-mcp",
      "env": {
        "HIGGSFIELD_API_KEY": "your-key",
        "HIGGSFIELD_SECRET": "your-secret"
      }
    }
  }
}

3. Restart Claude Code and start generating!

Configuration

1. Set up environment variables

Create a .env file in your project directory:

HIGGSFIELD_API_KEY=your-api-key-here
HIGGSFIELD_SECRET=your-secret-here

Or export them in your shell:

export HIGGSFIELD_API_KEY=your-api-key-here
export HIGGSFIELD_SECRET=your-secret-here

2. Configure MCP Client

Add to your MCP client configuration (e.g., Claude Desktop config.json):

{
  "mcpServers": {
    "higgsfield": {
      "command": "python",
      "args": ["-m", "higgsfield_mcp.server"],
      "env": {
        "HIGGSFIELD_API_KEY": "your-api-key-here",
        "HIGGSFIELD_SECRET": "your-secret-here"
      }
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "higgsfield": {
      "command": "higgsfield-mcp",
      "env": {
        "HIGGSFIELD_API_KEY": "your-api-key-here",
        "HIGGSFIELD_SECRET": "your-secret-here"
      }
    }
  }
}

Available Tools

Text-to-Image

generate_image_soul

Generate images from text prompts using the Soul model.

Parameters:

• prompt (required): Text description of the image
• width_and_height (optional): Image dimensions (default: “1696x960”)
  • Options: “1152x2048”, “2048x1152”, “2048x1536”, “1536x2048”, etc.