{"_id":"higgsfield-mcp","_rev":"3-80fc3bedba8896b4f8186d9fc758e010","name":"higgsfield-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"higgsfield-mcp","version":"0.1.0","keywords":["mcp","higgsfield","ai","image-generation","video-generation","talking-head","claude","model-context-protocol"],"license":"MIT","_id":"higgsfield-mcp@0.1.0","maintainers":[{"name":"souvik04","email":"souviksarkar4311@gmail.com"}],"homepage":"https://github.com/Storyvord/higgsfield-mcp#readme","bugs":{"url":"https://github.com/Storyvord/higgsfield-mcp/issues"},"bin":{"higgsfield-mcp":"src/server.js"},"dist":{"shasum":"a233a09920bd2f8530f52acc69672df2fc816091","tarball":"https://registry.npmjs.org/higgsfield-mcp/-/higgsfield-mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-4ULI+u1CBtr80Mgh50uD6BHmlSYpJqiyrIovgztpSMOJaxMlw0tPikjqIWihR53I3oTx/Ahi7sMMjqSbd3uzng==","signatures":[{"sig":"MEUCIQDuzwhVYNcKn5N6mE1P/ZoWZwMMRMR2LwnnxBeRjDhrQQIgPUG5ZLuvU/ls8xYKJXnEE7HwowHM3s5hKLRhgmyEmOg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29611},"main":"src/server.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"cf27ebe55b972586cb4f9dd4378a2d6f4b43197e","scripts":{"dev":"node --watch src/server.js","start":"node src/server.js"},"_npmUser":{"name":"souvik04","email":"souviksarkar4311@gmail.com"},"repository":{"url":"git+https://github.com/Storyvord/higgsfield-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Higgsfield AI cinematic image and video generation","directories":{},"_nodeVersion":"20.20.0","dependencies":{"dotenv":"^16.4.7","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/higgsfield-mcp_0.1.0_1775939973464_0.8098886604965931","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"higgsfield-mcp","version":"0.1.1","keywords":["mcp","higgsfield","ai","image-generation","video-generation","talking-head","claude","model-context-protocol"],"license":"MIT","_id":"higgsfield-mcp@0.1.1","maintainers":[{"name":"souvik04","email":"souviksarkar4311@gmail.com"}],"homepage":"https://github.com/s0uvik/higgsfield-mcp#readme","bugs":{"url":"https://github.com/s0uvik/higgsfield-mcp/issues"},"bin":{"higgsfield-mcp":"src/server.js"},"dist":{"shasum":"be3750d97d55ff378cf644e63ad6b59f4c24f452","tarball":"https://registry.npmjs.org/higgsfield-mcp/-/higgsfield-mcp-0.1.1.tgz","fileCount":5,"integrity":"sha512-IeXzjdIZy5cZgLO3NyY2cqWYTDGASw+zjYNo0vciZe/1ED+aDwTbhYxyOaQhVrglJHv+XaOQ4hCZ0bw6KFq/vQ==","signatures":[{"sig":"MEQCIGJ7nm7X1OVKew88Bx3mbQ9tzbaa81lBxS3q80VtT6cKAiBjVOoyRvHOsLDzIYwGEH9KtfyZZUUowLo9bTj17Q2sIg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29367},"main":"src/server.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c5e8db68d6033c7efe3109dc3b304cabe37f3139","scripts":{"dev":"node --watch src/server.js","start":"node src/server.js"},"_npmUser":{"name":"souvik04","email":"souviksarkar4311@gmail.com"},"repository":{"url":"git+https://github.com/s0uvik/higgsfield-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Higgsfield AI cinematic image and video generation","directories":{},"_nodeVersion":"20.20.0","dependencies":{"dotenv":"^16.4.7","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/higgsfield-mcp_0.1.1_1775978514805_0.5721026191729577","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"higgsfield-mcp","version":"0.2.0","description":"MCP server for Higgsfield AI cinematic image and video generation","type":"module","main":"src/server.js","bin":{"higgsfield-mcp":"src/server.js"},"scripts":{"start":"node src/server.js","dev":"node --watch src/server.js"},"keywords":["mcp","higgsfield","ai","image-generation","video-generation","talking-head","claude","model-context-protocol"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Storyvord/higgsfield-mcp.git"},"homepage":"https://github.com/Storyvord/higgsfield-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","dotenv":"^16.4.7"},"engines":{"node":">=18.0.0"},"_id":"higgsfield-mcp@0.2.0","gitHead":"f8cc6a840383ffad27945c9bb36d2140c259db85","bugs":{"url":"https://github.com/Storyvord/higgsfield-mcp/issues"},"_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-meOr721OINJ5GeeCdD5/5PkmdD6hOb3t7wyLWAB4iOpqp3ME+TgFKVC8NTEQ67rf+J3DjVwYUF3hJVFQx5fFag==","shasum":"6c6ff2d18bc819aa9346c43d88bb70515123490e","tarball":"https://registry.npmjs.org/higgsfield-mcp/-/higgsfield-mcp-0.2.0.tgz","fileCount":5,"unpackedSize":41877,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAu06mGR/NsBZyOkM2V/HHqVuritoftnUMsGCvLyPWMmAiEAlP2c0SExJKH+2QGOFTGXOGMYPA21V1BQkmVIKPNz3TQ="}]},"_npmUser":{"name":"souvik04","email":"souviksarkar4311@gmail.com"},"directories":{},"maintainers":[{"name":"souvik04","email":"souviksarkar4311@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/higgsfield-mcp_0.2.0_1776944979573_0.538181747541882"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-11T20:39:33.463Z","modified":"2026-04-23T11:49:39.807Z","0.1.0":"2026-04-11T20:39:33.612Z","0.1.1":"2026-04-12T07:21:54.960Z","0.2.0":"2026-04-23T11:49:39.709Z"},"bugs":{"url":"https://github.com/Storyvord/higgsfield-mcp/issues"},"license":"MIT","homepage":"https://github.com/Storyvord/higgsfield-mcp#readme","keywords":["mcp","higgsfield","ai","image-generation","video-generation","talking-head","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/Storyvord/higgsfield-mcp.git"},"description":"MCP server for Higgsfield AI cinematic image and video generation","maintainers":[{"name":"souvik04","email":"souviksarkar4311@gmail.com"}],"readme":"# Higgsfield MCP\n\nMCP server for [Higgsfield AI](https://higgsfield.ai) — generate images and videos directly from Claude or any MCP-compatible client.\n\n---\n\n## Setup\n\n**Node.js 18+ required.** Get your API keys at <https://cloud.higgsfield.ai/api-keys>.\n\n### Claude Desktop\n\nEdit `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"higgsfield\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"higgsfield-mcp\"],\n      \"env\": {\n        \"HF_API_KEY\": \"your_api_key\",\n        \"HF_SECRET\": \"your_secret\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add higgsfield -- npx -y higgsfield-mcp\nexport HF_API_KEY=your_api_key\nexport HF_SECRET=your_secret\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/Storyvord/higgsfield-mcp.git\ncd higgsfield-mcp\nnpm install\ncp .env.example .env   # add your keys\nnpm start\n```\n\n---\n\n## Tools\n\n### Image Generation\n\n| Tool | Model | Notes |\n|------|-------|-------|\n| `generate_image` | Soul | Supports style presets and character references |\n| `generate_image_reve` | Reve | |\n| `generate_image_seedream` | Seedream v4 | Optional `camera_fixed` param |\n| `edit_image_seedream` | Seedream v4 Edit | Edit existing images via prompt |\n\n### Video Generation\n\n| Tool | Model | Notes |\n|------|-------|-------|\n| `generate_video` | DoP (lite/turbo/standard) | Requires a `motion_id` |\n| `generate_video_kling` | Kling v2.1 Pro | Prompt = camera movement instructions |\n| `generate_video_seedance` | Seedance v1 Pro | Prompt = movement/action description |\n| `generate_video_dop_standard` | DoP Standard | Optional `duration` (2–10s) |\n| `generate_talking_head` | Speak v2 | Portrait + WAV audio → lip-synced video |\n\n### Status & Control\n\n| Tool | Notes |\n|------|-------|\n| `get_generation_status` | Poll Soul/DoP/TalkingHead jobs (`job_set_id`) |\n| `get_request_status` | Poll all other generation jobs (`request_id`) |\n| `cancel_request` | Cancel a queued job |\n\n### Characters\n\n| Tool | Notes |\n|------|-------|\n| `create_character` | 1–5 face images → reusable `character_id`. Costs 40 credits. |\n| `list_characters` | All characters with status and thumbnails |\n| `get_character` | Single character by ID |\n| `delete_character` | Permanently delete a character |\n\n### Upload\n\n| Tool | Notes |\n|------|-------|\n| `upload_image` | Upload base64 image → get public URL for use in generation tools |\n\n### Lookup\n\n| Tool | Notes |\n|------|-------|\n| `list_styles` | Style presets for `generate_image` |\n| `list_motions` | Motion presets for `generate_video` |\n| `debug_credentials` | Verify keys are loaded |\n\n### Resources\n\nBrowse these before generating:\n\n- `higgsfield://styles` — style IDs for `generate_image`\n- `higgsfield://motions` — motion IDs for `generate_video`\n- `higgsfield://characters` — your character references\n\n---\n\n## How Jobs Work\n\nTools return either a `job_set_id` or `request_id`. Poll the matching status tool until `completed`, then download the output URL. Results are kept for **7 days**.\n\n```\ngenerate_image(...)             → job_set_id  → get_generation_status(job_set_id)\ngenerate_image_reve(...)        → request_id  → get_request_status(request_id)\ngenerate_video_kling(...)       → request_id  → get_request_status(request_id)\n```\n\nAll tools accept an optional `webhook_url` to receive a callback when the job finishes.\n\n---\n\n## Talking Head Note\n\nAudio must be **WAV format**. Convert with:\n\n```bash\nffmpeg -i speech.mp3 -acodec pcm_s16le -ar 44100 speech.wav\n```\n\n---\n\n## Credits\n\n| Operation | Credits | USD |\n|-----------|---------|-----|\n| Image 720p | 1.5 | $0.09 |\n| Image 1080p | 3 | $0.19 |\n| Video lite | 2 | $0.13 |\n| Video turbo | 6.5 | $0.41 |\n| Video standard | 9 | $0.56 |\n| Character (one-time) | 40 | $2.50 |\n\nTop up at <https://cloud.higgsfield.ai/credits>\n\n---\n\n## Links\n\n- [Higgsfield Platform](https://higgsfield.ai)\n- [API Docs](https://platform.higgsfield.ai/docs)\n- [MCP Specification](https://modelcontextprotocol.io)\n","readmeFilename":"README.md"}