{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wjzrxfd4pw5p","handle":"higgsfield-mcp-unified","url":"https://wellknown.network/agents/higgsfield-mcp-unified","links":{"self":"https://wellknown.network/agents/higgsfield-mcp-unified/record.json","html":"https://wellknown.network/agents/higgsfield-mcp-unified","markdown":"https://wellknown.network/agents/higgsfield-mcp-unified/record.md","api":"https://wellknown.network/api/v1/agents/higgsfield-mcp-unified","status":"https://wellknown.network/api/v1/agents/higgsfield-mcp-unified/status","claim":"https://wellknown.network/agents/higgsfield-mcp-unified/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/higgsfield-mcp-unified/claim.json","badge":"https://wellknown.network/agents/higgsfield-mcp-unified/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/higgsfield-mcp-unified/history","tools":"https://wellknown.network/api/v1/agents/higgsfield-mcp-unified/tools"},"ard":{"identifier":"urn:air::server:higgsfield-mcp-unified","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"higgsfield-mcp-unified","summary":"Unified MCP server for Higgsfield AI: official api.higgsfield.ai API + opt-in cloud.higgsfield.ai web backend, exposing 119 image and video models.","description":"# higgsfield-mcp-unified\n\nA local-first [Model Context Protocol](https://modelcontextprotocol.io) server for [Higgsfield AI](https://higgsfield.ai/).\nIt puts **85 models from the official Higgsfield API**: Seedance 2.5, Kling 3.0 / O3 / Omni, Wan 3, Genjutsu, Cinema Studio 4, Soul, Marketing Studio, Recraft, Ideogram and more.\nSoul character training, webhooks, cost estimates and preset catalogs sit behind the same typed tool surface, which any MCP client (Claude Desktop, Claude Code, Cursor, …) can use.\nAn opt-in experimental backend adds 34 consumer-app models such as Sora 2, Veo 3 and Nano Banana.\n\n> **Status: alpha.**\n> The official-API path follows [docs.higgsfield.ai](https://docs.higgsfield.ai/docs) and has been cross-checked against the [open.higgsfield.ai](https://open.higgsfield.ai/explore) console.\n\n## Why this over the hosted MCP\n\nThe official hosted MCP (`mcp.higgsfield.ai`) runs on Higgsfield's servers behind OAuth.\nThis one runs **on your machine** with your API key, and adds:\n\n- **The full API catalog, typed.** Every documented endpoint has its parameters, enums, ranges and defaults, so the model picks valid values before spending credits.\n- **Discovery that costs nothing.** `estimate_cost` prices a request, while `recommend_model`, `validate_params` and `preflight_check` work without running a generation.\n- **Structured output.** Every tool returns a schema'd result (`outputSchema` + `structuredContent`), not an opaque blob.\n- **Built-in reliability.**\n  - Every submit carries an idempotency key, so retries (backoff with jitter, plus a circuit breaker) never double-charge.\n  - Errors come back as typed cases: auth, out of credits, concurrency limit, bot challenge, network.\n- **Webhooks and every output type.** It surfaces images, video, audio and the extra video/3D files (zip, mov, jsx, fbx, ply).\n\n## Install\n\nThe package is [`higgsfield-mcp-unified`](https://pypi.org/project/higgsfield-mcp-unified/) on PyPI, and its command is `higgsfield-mcp`.\nWi…","publisher":{"name":"Hikhakk","url":null},"homepage":"https://github.com/Hikhakk/higgsfield-mcp-unified","repository":"https://github.com/Hikhakk/higgsfield-mcp-unified/blob/main/CHANGELOG.md","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","higgsfield","ai","image-generation","video-generation","sora","veo","kling"],"pricing":null,"endpoints":[{"url":"pypi:higgsfield-mcp-unified","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-generation","name":"Image Generation","confidence":1,"provenance":"declared"},{"slug":"media.video-generation","name":"Video Generation","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.745,"provenance":"derived"}],"categories":["dev","media","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"higgsfield-mcp-unified","registry":"pypi","observedAt":"2026-10-24T17:29:04.133Z","publishedAt":"2026-10-17T12:04:15.821799Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"higgsfield-mcp-unified","url":"https://pypi.org/project/higgsfield-mcp-unified/","firstSeenAt":"2026-10-18T16:29:00.417Z","fetchedAt":"2026-10-24T17:27:35.226Z","normalizedAt":"2026-10-24T17:27:35.226Z"}]},"firstSeenAt":"2026-10-18T16:29:00.417Z","updatedAt":"2026-10-24T17:29:04.133Z"}