How geopopos/higgsfield_ai_mcp works
Higgsfield AI MCP Server exposes image, video, talking-head, and character-generation operations, plus resources for browsing styles, motions, and characters. An MCP client invokes server tools or reads resources; the server delegates API work to the async client, which communicates with Higgsfield. The README documents the user workflow of browsing presets, starting generation, polling for results, and optionally creating reusable characters. The source excerpts show the server-to-client calls and client HTTP operations; unsampled server sections limit certainty about some tool implementations.
Main entry points: server.py MCP server · client.py Async API client
Components 11
MCP interface
- MCP server
src/higgsfield_mcp/server.py
Generation workflows
- Image generation
src/higgsfield_mcp/server.py - Image-to-video
src/higgsfield_mcp/server.py - Talking-head video
src/higgsfield_mcp/server.py - Job status and results
src/higgsfield_mcp/server.py
Presets and characters
- Preset resources
src/higgsfield_mcp/server.py - Character references
src/higgsfield_mcp/server.py
API integration
- Async API client
src/higgsfield_mcp/client.py - Higgsfield API
Other components
- MCP user
- MCP host
Connections 18
- MCP user → MCP host: requests tools
README.md - MCP host → MCP server: invokes tools
README.md - MCP server → Image generation: registers tools
src/higgsfield_mcp/server.py - MCP server → Image-to-video: registers tools
src/higgsfield_mcp/server.py - MCP server → Talking-head video: registers tools
src/higgsfield_mcp/server.py - MCP server → Job status and results: registers tools
src/higgsfield_mcp/server.py - MCP server → Preset resources: registers resources
src/higgsfield_mcp/server.py - MCP server → Character references: registers tools
src/higgsfield_mcp/server.py - Image generation → Async API client: starts generation
src/higgsfield_mcp/server.py - Image-to-video → Async API client: starts generation
src/higgsfield_mcp/server.py - Talking-head video → Async API client: starts generation
src/higgsfield_mcp/server.py - Job status and results → Async API client: fetches job
src/higgsfield_mcp/server.py - Preset resources → Async API client: fetches presets
src/higgsfield_mcp/server.py - Character references → Async API client: manages references
src/higgsfield_mcp/server.py - Async API client → Higgsfield API: sends API requests
src/higgsfield_mcp/client.py - MCP user → Preset resources: browses presets
README.md - MCP user → Job status and results: polls job
README.md - MCP user → Character references: creates references
README.md