Report

or # Notes\n\nHello.",204800,"Optional MIME type, such as text/html or application/pdf. It must match the filename extension; omit it to infer the type from the filename. Omit it with source_file_id; the stored upload already carries a content type.","The filename to create in Notion, including a supported extension such as .html, .md, .pdf, or .png. Required with content and source_url. Omit it with source_file_id; the stored upload already carries a filename.","notion_notion_fetch","Notion fetch","Retrieves details about a Notion entity (page, database, data source, or saved database view) by URL or ID. Provide a URL or ID in `id`. Make multiple calls for multiple entities. For pages, use path, verification, edit time, and truncation metadata to assess the source. Treat recency as context, not proof. Report material uncertainty when sources conflict. Pages use enhanced Markdown format. For the complete specification, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion \"fetch\" tool with this URI if your client does not support reading MCP resources. Do NOT pass this URI to any other URL-fetching tool. Pass a `notion://docs/*` URI as `id` to read that MCP documentation resource. Databases return data sources in `` tags. Fetch the collection:// URL for its schema and use it with update_data_source or query_data_sources. Multi-source databases return more than one data source. Saved views …",{"_409":410,"_411":3762,"_413":414,"_433":3763,"_417":3764},{"_406":407,"_53":408},{"_406":3765,"_3766":3767,"_3768":3769,"_3770":3771},[406],{},{"_409":442,"_396":3775},"include_transcript",{"_396":3774,"_409":1097},"include_discussions",{"_396":3773,"_409":1097},"include_file_urls",{"_396":3772,"_409":1097},"Whether to return signed download URLs for uploaded files. Defaults to false. When false, page Markdown cites uploaded files by stable notion-file-block:// references and the response has no references map; call get_file_download_urls with the references when you need those files' contents. When true, the response's references map gives the signed URL for each reference.","Whether to include discussion/comment indicators in the page output. When true, adds a summary with discussion count, preview snippets, and discussion:// URLs. Use with the get_comments tool to retrieve full discussion content. Defaults to false.","Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.","The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass \"memory\" to fetch the connected user's About page and memory database in this workspace without creating them. Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec.","notion_notion_get_tool_access","Notion get tool access","Get current tool availability, parameter restrictions, and available upgrade links for this Notion connection. This lookup is optional: tools apply access limits themselves and report them in their results as notices or errors with upgrade links. Use it when the user asks which Notion tools or features are available, or after a result reports restricted access or an upgrade requirement. Call with {} for the full access map, or pass tool_names to narrow the result. Unknown names and tools not exposed to this connection are omitted. The map may report AI search access under ai_search; use search for every content search, which runs AI search when it is available. Tool availability and restricted_parameters are independent. This tool does not grant access or change the workspace.",{"_409":410,"_411":3781,"_413":414,"_417":418},{"_406":407,"_53":408},{"_3782":3783},"tool_names",{"_396":3784,"_595":516,"_409":596,"_597":3785},"Optional RunTool names to include, such as search and ai_search. Omit to return all tools visible to this connection. Unknown or unexposed names are omitted. An empty list returns an empty map.",{"_409":442,"_497":30,"_974":516},"notion_notion_memory_search","Notion memory search","Search memories that the user's connected agents saved in earlier sessions: context, preferences, corrections, and decisions. Returns the best matches, not every memory. To list, count, or filter memories, fetch id \"memory\" and run query-data-sources on its data source. The first time you use memory in a conversation, whether searching or saving, read notion://docs/memory once.",{"_409":410,"_411":3791,"_413":414,"_433":3792,"_417":418},{"_406":407,"_53":408},{"_581":3793,"_1000":3794},[581],{"_409":442,"_497":30,"_974":3797,"_396":3798},{"_396":3795,"_409":492,"_493":30,"_494":3796},"Maximum number of memories to return. Defaults to 10 and cannot exceed 50.",50,500,"Words or a short phrase to find in personal memories.","notion_notion_search","Notion search","Search Notion with short, specific keywords, or look up a user by name or email. Use this tool for every content search. This workspace uses keyword search, so prefer distinctive words from page titles or content over full questions. AI search, which answers natural-language questions and also searches connected sources, requires a Business or Enterprise plan with Notion AI. Start with a non-empty query and omit optional parameters unless needed. Do not add filters or sorting just to fill in defaults. Business or Enterprise is required for filters.edited_by_user_ids, filters.last_edited_date_range, filters.title_only=true, filters.content_status, more than one distinct teamspace across teamspace_id and filters.teamspace_ids, and sort other than relevance. On other plans, those options are dropped with a notice in the result, and results may be broader. Keep filters nested inside \"filters\". Use page_size, not limit. For user lookup, set query_type=\"user\" and provide a name or email. A document about a person …",{"_409":410,"_411":3804,"_413":414,"_433":3805,"_417":3806},{"_406":407,"_53":408},{"_581":3807,"_3808":3809,"_1483":3810,"_3496":3811,"_3645":3812,"_1058":3813,"_1487":3814,"_589":3815,"_3816":3817},[581],{},{"_409":442,"_396":3871},"query_type",{"_396":3868,"_409":442,"_465":3869},{"_396":3867,"_409":442},{"_396":3866,"_409":442},{"_396":3865,"_409":442},{"_396":3825,"_409":410,"_411":3826,"_417":3827},{"_396":3820,"_409":442,"_465":3821},{"_396":3819,"_409":492,"_493":30,"_494":3796},"max_highlight_length",{"_396":3818,"_409":492,"_493":38,"_494":3797},"Maximum character length for result highlights (default 200). Set to 0 to omit highlights entirely.","Maximum number of results to return (default 10). Lower values reduce response size.","Result ordering for Notion workspace search. Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" require Business access.",[3822,3823,3824],"relevance","last_edited","created","Optional exact filters for Notion workspace search. Omit unless required by the request. Keep filter fields nested here; do not send them at the top level. Some filters require Business access.",{"_3828":3829,"_3830":3831,"_3832":3833,"_3834":3835,"_3836":3837,"_3838":3839,"_3840":3841},{},"created_date_range",{"_396":3861,"_409":410,"_411":3862,"_417":418},"created_by_user_ids",{"_396":3859,"_595":516,"_409":596,"_597":3860},"edited_by_user_ids",{"_396":3857,"_595":516,"_409":596,"_597":3858},"last_edited_date_range",{"_396":3851,"_409":410,"_411":3852,"_417":418},"teamspace_ids",{"_396":3849,"_595":516,"_409":596,"_597":3850},"title_only",{"_396":3848,"_409":1097},"content_status",{"_396":3842,"_409":442,"_465":3843},"Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.",[3844,3845,3846,3847],"all_with_archived","all_without_archived","verified_only","archived_only","When true, match the query only against page and database titles instead of page content. Available on the Business plan.","Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.",{"_409":442},"Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.",{"_1112":3853,"_1114":3854},{"_396":3856,"_409":442,"_1117":1118,"_1119":1120},{"_396":3855,"_409":442,"_1117":1118,"_1119":1120},"The end date of the date range as an ISO 8601 date string, if any.","The start date of the date range as an ISO 8601 date string, if any.","Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Use \"me\" for the connected user. Available on the Business plan.",{"_409":442},"Optional filter to only produce search results created by the Notion users that have the specified user IDs. Use \"me\" for the connected user.",{"_409":442},"Optional filter to only produce search results created within the specified date range.",{"_1112":3863,"_1114":3864},{"_396":3856,"_409":442,"_1117":1118,"_1119":1120},{"_396":3855,"_409":442,"_1117":1118,"_1119":1120},"Optionally, provide the ID of a teamspace to restrict search results to. This will perform a search over content within the specified teamspace only. Accepts the teamspace ID (UUIDv4) with or without dashes.","Optionally restrict keyword search to a page and its descendants. Accepts a Notion page URL or ID.","Optionally restrict keyword search to a data source URL returned in a tag.","Specify type of the query as either \"internal\" or \"user\". Always include this input if performing \"user\" search.",[3870,3093],"internal","Short, specific keywords for Notion content search. For user search, enter a name or email address. Provide a non-empty query unless intentionally browsing with filters or a non-relevance sort.","gdrive_keep","Bring a file here","Download one file from Drive into Files on this computer — from there the chat, with a phone picked, puts it in the camera roll.",{"_409":410,"_411":3879,"_433":3880,"_417":418},{"_406":3877,"_53":3878},"gdrive","Google Drive",{"_3881":3882},[3881],"file",{"_409":442,"_396":3883},"The file's id, from find, or its link.","gdrive_find","Find files","Find videos (or pictures) on the person's Google Drive — in one folder, by its link or name, or by words in their names. Newest first.",{"_409":410,"_411":3889,"_433":3890,"_417":418},{"_406":3877,"_53":3878},{"_3891":3892,"_3893":3894,"_99":3895},[],"folder",{"_409":442,"_396":3901},"words",{"_409":442,"_396":3900},{"_409":442,"_396":3896,"_465":3897},"What to find. Default video.",[3898,3899,1908],"video","image","Words in the files' names. Optional.","A folder's link or name. Optional.","slideshow_make","Make a slideshow","Turn pictures kept in Files into a vertical 1080×1920 video, a few seconds each with an optional line of text over each, and an optional sound (a voiceover kept in Files) under it. Keeps the video in Files.",{"_409":410,"_411":3909,"_433":3910,"_417":418},{"_406":3907,"_53":3908},"slideshow","Slideshows",{"_3911":3912,"_3913":3914,"_3915":3916,"_3917":3918},[3911],"pictures",{"_409":596,"_396":3925,"_597":3926},"texts",{"_409":596,"_396":3922,"_597":3923},"seconds_each",{"_409":1006,"_396":3920,"_493":30,"_494":3921},"sound",{"_409":442,"_396":3919},"A kept sound's id to play under it. Optional.","How long each picture shows, 1 to 8. Default 2.5.",8,"A line of text for each picture, in the same order. Optional.",{"_409":442,"_396":3924},"The words.","The kept pictures' ids, in order (2 to 12).",{"_409":442,"_396":3927},"A kept picture's id.","appstore_search","Search the App Store","Find apps on the App Store by words — a rival, a category. Answers each app's name, maker, rating, price and link.",{"_409":410,"_411":3935,"_433":3936,"_417":418},{"_406":3933,"_53":3934},"appstore","App Store lookup",{"_3937":3938,"_3939":3940,"_1000":3941},[3937],"term",{"_409":442,"_396":3945},"country",{"_409":442,"_396":3944},{"_409":1006,"_396":3942,"_493":30,"_494":3943},"How many, 1 to 10. Default 5.",10,"Two-letter store country, e.g. us, gb, fr. Default us.","What to search for.","appstore_lookup","Look up an app","What an app's App Store page says: name, maker, description, category, price, rating and icon. Takes an App Store link or id.",{"_409":410,"_411":3951,"_433":3952,"_417":418},{"_406":3933,"_53":3934},{"_3119":3953},[3119],{"_409":442,"_396":3954},"An App Store link, or the app's id.","telegram_message_me","Message you","Send a short message to the person's own Telegram. Use it when they asked to be told when something finishes or needs them — never otherwise.",{"_409":410,"_411":3962,"_433":3963,"_417":418},{"_406":3960,"_53":3961},"telegram","Telegram",{"_1893":3964},[1893],{"_409":442,"_396":3965},"The message, one or two sentences.","higgsfield_katana_compose_message","Katana compose message","Validate a filled Katana preset form and return the chat message that starts the preset.",{"_409":410,"_411":3973,"_413":414,"_433":3974,"_417":418},{"_406":3971,"_53":3972},"higgsfield","Higgsfield",{"_51":3976,"_3975":3977},[51,3975],"inputs",{"_409":442,"_974":3980,"_1119":3981},{"_409":410,"_3586":3978,"_417":3979},{"_409":442},{},128,"^[a-z0-9]+(?:-[a-z0-9]+)*$","higgsfield_assets_picker_list","Assets picker list","List existing uploaded, generated, or liked image/video assets for an app picker. Invoked only by the app; never uploads, generates, or modifies assets. Sort applies only to uploads.",{"_409":410,"_411":3987,"_413":414,"_433":3988,"_417":418},{"_406":3971,"_53":3972},{"_3989":3990,"_99":3991,"_1002":3992,"_3993":3994,"_1487":3995},[3989,99],"source",{"_409":442,"_465":4008},{"_409":442,"_465":4007},{"_396":4002,"_614":4003},"size",{"_415":4001,"_409":492,"_493":30,"_494":3796},{"_415":3996,"_396":3997,"_409":442,"_465":3998},"newest","Uploads only: newest/oldest creation time or most recently used. Ignored for generations and liked assets.",[3996,3999,4000],"oldest","last-used",30,"Continuation cursor returned by this picker for the same source, kind and upload sort.",[4004,4005],{"_409":442,"_497":30,"_974":4006},{"_409":1006},2048,[3899,3898],[4009,4010,4011,4012,4013],"uploads","generations","liked","influencer","influencer-liked","higgsfield_visual_effects_history","Visual effects history","Read one page of the user's accessible Viral preset generations. Does not generate media.",{"_409":410,"_411":4019,"_413":414},{"_406":3971,"_53":3972},{"_1002":4020,"_3993":4021},{"_409":442,"_1119":4022},{"_415":3796,"_409":492,"_493":30,"_494":3796},"^\\d+(?:\\.\\d+)?$","higgsfield_visual_effects_samples","Visual effects samples","Read approved public examples and their input media for a visual preset. Does not generate media.",{"_409":410,"_411":4028,"_413":414,"_433":4029},{"_406":3971,"_53":3972},{"_4030":4031},[4030],"preset_id",{"_409":442,"_1117":3481,"_1119":3482},"higgsfield_visual_effects_list","Visual effects list","Read the website's public visual preset previews and category filters. Does not generate media.",{"_409":410,"_411":4037,"_413":414},{"_406":3971,"_53":3972},{"_4038":4039,"_1002":4040,"_3993":4041},"category",{"_415":4042,"_409":442,"_497":30,"_974":4043},{"_415":38,"_409":492,"_493":38,"_494":495},{"_415":3796,"_409":492,"_493":30,"_494":3796},"all",120,"higgsfield_ai_influencer_character_sheet_presets","Ai influencer character sheet presets","App-only: load a page of AI Influencer character sheet presets with preview media and recreate parameters.",{"_409":410,"_411":4049,"_413":414},{"_406":3971,"_53":3972},{"_4030":4050,"_1002":4051,"_3993":4052},{"_409":442,"_1117":3481,"_1119":3482},{"_396":4054,"_409":492,"_493":30,"_494":4055},{"_396":4053,"_409":492,"_493":30,"_494":516},"Page size; defaults to 20.","Cursor from the previous page; omit for the first page.",1000000,"higgsfield_tiktok_publish_status","Tiktok publish status","Step 3 of publishing. Fetch processing status for a publish_id returned by tiktok_publish. TikTok may take a few minutes to process before the post is live. Read-only.",{"_409":410,"_411":4061,"_413":414,"_433":4062},{"_406":3971,"_53":3972},{"_4063":4065,"_4064":4066},[4063,4064],"connector_id","publish_id",{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_396":4067},"From tiktok_publish.","higgsfield_tiktok_publish","Tiktok publish","Publish a prepared TikTok post from the publish-form widget after the user reviews and submits it. Requires the short-lived publish_token delivered only in tiktok_prepare_publish result metadata. Chat confirmations and boolean attestations do not authorize publication. Use tiktok_prepare_publish to open the form; clients without MCP Apps cannot publish. Track a submitted post with tiktok_publish_status. PUBLISH QUOTAS per account, enforced before TikTok is called: at most 5 posts per minute and 13 posts per 24 hours, both rolling (TikTok's own ceiling is 6/minute and 15/day). A rejection returns code=cadence_burst or cadence_daily plus retry_after_seconds — wait that long instead of retrying, since retrying sooner only earns another rejection. Failed attempts and drafts do not consume quota; a post TikTok accepted does. Duration, frame size and frame rate are measured from the media file itself by tiktok_prepare_publish, before a publish slot is spent — there is no duration argument, never ask the user for o…",{"_409":410,"_411":4073,"_413":414,"_433":4074},{"_406":3971,"_53":3972},{"_4063":4078,"_4075":4079,"_4076":4080,"_1450":4081,"_4077":4082,"_1295":4083,"_396":4084,"_4085":4086,"_4087":4088,"_4089":4090,"_4091":4092,"_4093":4094,"_4095":4096,"_4097":4098,"_4099":4100,"_4101":4102,"_4103":4104,"_4105":4106,"_4107":4108},[4063,4075,4076,1450,4077],"publish_token","publish_session_id","media_type",{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_974":4006,"_396":4139},{"_409":442,"_1117":3481,"_1119":3482,"_396":4138},{"_409":442,"_465":4135},{"_409":442,"_465":4132},{"_409":442,"_974":4131},{"_409":442,"_974":4130},"privacy_level",{"_396":4124,"_409":442,"_465":4125},"allow_comment",{"_409":1097},"allow_duet",{"_409":1097},"allow_stitch",{"_409":1097},"auto_add_music",{"_409":1097},"music_sound_id",{"_396":4123,"_409":442},"music_sound_volume",{"_396":4122,"_409":492,"_493":38,"_494":516},"video_original_sound_volume",{"_396":4121,"_409":492,"_493":38,"_494":516},"music_sound_start",{"_396":4120,"_409":492,"_493":38,"_494":495},"music_sound_end",{"_396":4119,"_409":492,"_493":38,"_494":495},"is_aigc",{"_396":4118,"_409":1097},"commercial_content_disclosure",{"_396":4109,"_409":410,"_411":4110,"_433":4111},"DIRECT_POST: if enabled, at least one of your_brand / branded_content must be true.",{"_4112":4115,"_4113":4116,"_4114":4117},[4112,4113,4114],"enabled","your_brand","branded_content",{"_409":1097},{"_409":1097},{"_409":1097},"Set true for AI-generated/edited media (AIGC disclosure).","Track trim end in milliseconds. Defaults to the video duration. VIDEO only.","Track trim start in milliseconds (65000 starts the track at 1:05). Defaults to the track beginning. VIDEO only.","Original video audio volume 0-100. Defaults to 50 (0 mutes the user's own audio). VIDEO only.","Track volume 0-100. Defaults to 50. VIDEO only.","Commercial Music Library track to attach: song_clip_id from tiktok_music_trending. DIRECT_POST only — drafts don't keep music. Mutually exclusive with auto_add_music.","Required for DIRECT_POST; pick from prepare's privacy_level_options.",[4126,4127,4128,4129],"PUBLIC_TO_EVERYONE","MUTUAL_FOLLOW_FRIENDS","FOLLOWER_OF_CREATOR","SELF_ONLY",4000,150,[4133,4134],"VIDEO","PHOTO",[4136,4137],"DIRECT_POST","UPLOAD_TO_DRAFT","From tiktok_prepare_publish.","Widget-only authorization from prepare result metadata.","higgsfield_tiktok_prepare_publish","Tiktok prepare publish","Step 1 of publishing to TikTok. Validates the media and TikTok account, creates a publish session, and returns what the user must review and choose (preview, privacy options, required declarations, confirmations). The media URL must be a Higgsfield-hosted asset (TikTok requires a verified source domain). The user reviews and submits the publish-form widget, including optional music selection and tuning. Do not call tiktok_publish yourself. Clients without MCP Apps cannot publish. mode=DIRECT_POST posts to the profile; mode=UPLOAD_TO_DRAFT saves to the user's TikTok drafts. MEDIA LIMITS — check before calling, and convert or downscale locally if a file does not comply; a rejected file costs a full convert-and-re-upload round trip, and TikTok rejects some files only asynchronously, after the post was submitted. Photos: JPEG or WebP only (PNG is rejected by TikTok, and Higgsfield image generation emits PNG — convert first), each at most 20 MB, resolution must fit within 1920x1080 or 1080x1920, up to 35 images. …",{"_409":410,"_411":4145,"_413":414,"_433":4146},{"_406":3971,"_53":3972},{"_4063":4147,"_1450":4148,"_4077":4149,"_4150":4151,"_4152":4153,"_4154":4155,"_1295":4156,"_396":4157,"_4085":4158,"_4087":4159,"_4089":4160,"_4091":4161,"_4105":4162,"_4107":4163},[4063,1450,4077],{"_409":442,"_1117":3481,"_1119":3482,"_396":4181},{"_409":442,"_465":4180},{"_409":442,"_465":4179},"video_url",{"_396":4178,"_409":442,"_1117":4177},"photo_images",{"_396":4174,"_594":30,"_595":4175,"_409":596,"_597":4176},"photo_cover_index",{"_409":492,"_493":38,"_494":495},{"_396":4173,"_409":442,"_974":4131},{"_409":442,"_974":4130},{"_396":4171,"_409":442,"_465":4172},{"_396":4164,"_409":1097},{"_396":4164,"_409":1097},{"_396":4164,"_409":1097},{"_396":4170,"_409":1097},{"_396":4164,"_409":410,"_411":4165,"_433":4166},"Prefill — only if the user already stated it.",{"_4112":4167,"_4113":4168,"_4114":4169},[4112,4113,4114],{"_409":1097},{"_409":1097},{"_409":1097},"Prefill — only if the user already stated whether the media is AI-generated.","Prefill for the publish form — pass ONLY if the user already stated it explicitly.",[4126,4127,4128,4129],"Caption / title.","Required for PHOTO. Higgsfield-hosted image URLs.",35,{"_409":442,"_1117":4177},"uri","Required for VIDEO. Must be a Higgsfield-hosted asset URL.",[4133,4134],[4136,4137],"Active TikTok account from tiktok_accounts.","higgsfield_tiktok_music_tune","Tiktok music tune","Open the tuning editor for one Commercial Music Library track the user already picked (via tiktok_music_trending): trim start/end and set track/original volumes. Pass the same genre/country_code/date_range filters that were used when the track was found, or the lookup may miss. This editor previews settings only; they are not applied to the post. For publication, ask the user to select and tune music in the publish-form widget opened by tiktok_prepare_publish. Read-only.",{"_409":410,"_411":4187,"_413":414,"_433":4188},{"_406":3971,"_53":3972},{"_4063":4189,"_4095":4190,"_4191":4192,"_4193":4194,"_4195":4196},[4063,4095],{"_409":442,"_1117":3481,"_1119":3482,"_396":4181},{"_409":442,"_396":4203},"genre",{"_396":4202,"_409":442},"country_code",{"_409":442},"date_range",{"_409":442,"_465":4197},[4198,4199,4200,4201],"1DAY","7DAY","30DAY","90DAY","Same filter the track was found with, if any.","The picked track's id (from tiktok_music_trending / the user's paste).","higgsfield_tiktok_music_trending","Tiktok music trending","List trending commercially licensed tracks from TikTok's Commercial Music Library for the connected account. Show the user tracks with their listen links. To attach music, ask the user to select and tune it in the publish-form widget opened by tiktok_prepare_publish; choices here are not applied to the post. Music works for DIRECT_POST only (TikTok drafts don't keep it). There is no keyword search — offer genre/country/date_range filters instead. Read-only.",{"_409":410,"_411":4209,"_413":414,"_433":4210},{"_406":3971,"_53":3972},{"_4063":4211,"_4191":4212,"_4193":4213,"_4195":4214,"_1000":4215,"_4216":4217},[4063],{"_409":442,"_1117":3481,"_1119":3482,"_396":4181},{"_396":4223,"_409":442},{"_396":4222,"_409":442},{"_396":4220,"_409":442,"_465":4221},{"_396":4219,"_409":492,"_493":30,"_494":516},"offset",{"_396":4218,"_409":492,"_493":38,"_494":495},"Page start. Default 0.","Tracks per page. Default 10.","Popularity window. Default 7DAY.",[4198,4199,4200,4201],"Region whose trending chart to use, e.g. US. Default US.","TikTok CML genre enum, e.g. ALL, POP, HIP_HOP/RAP, LO-FI, EDM, COUNTRY, K-POP, CHILL_BEATS, EPIC. Default ALL.","higgsfield_tiktok_reconnect","Tiktok reconnect","Re-run the TikTok OAuth for an existing connector in `error` status (expired/revoked access). Returns a fresh authorize_url — show it to the user as a link, then verify with tiktok_accounts.",{"_409":410,"_411":4229,"_413":414,"_433":4230},{"_406":3971,"_53":3972},{"_4063":4231},[4063],{"_409":442,"_1117":3481,"_1119":3482,"_396":4232},"The connector to reconnect, from tiktok_accounts.","higgsfield_tiktok_connect","Tiktok connect","Start connecting the user's TikTok account. Returns an authorize_url — show it to the user as a link; they open it in a browser, approve access on TikTok, and land on a confirmation page. Afterwards call tiktok_accounts to verify the account became `active`. The URL expires in ~10 minutes. If an account already exists in `error` status, use tiktok_reconnect instead.",{"_409":410,"_411":4238,"_413":414},{"_406":3971,"_53":3972},{"_53":4239},{"_396":4240,"_409":442,"_497":30,"_974":4241},"Only when connecting a SECOND account: a distinct label, e.g. \"tiktok-brand\". Default \"tiktok\".",64,"higgsfield_tiktok_accounts","Tiktok accounts","List the user's connected TikTok accounts. Returns each account's connector_id (needed by other tiktok_* tools) and status. `active` accounts are ready; `error` accounts need tiktok_reconnect; no accounts ⇒ offer tiktok_connect. Read-only.",{"_409":410,"_411":4247,"_413":414},{"_406":3971,"_53":3972},{},"higgsfield_ai_influencer_generate","Ai influencer generate","Generate and save one to four AI Influencer character sheets in the selected Higgsfield workspace from exact params returned by ai_influencer_prepare. Does not train a Soul or generate video. Rechecks price before submission and rejects paid prices above max_credits. Paid generation spends existing credits; it does not purchase credits or subscriptions. use_free_gens=true requires explicit user intent and backend eligibility, with max_credits=0 for free-only requests; never falls back to paid generation. Returns job_id for the first accepted job and job_ids for a batch before completion; wait for every returned job. Free generations always submit one sheet. Repeating this call can create another job and spend credits again; never automatically retry an uncertain submission. An auto-updating generation widget shows every accepted sheet and its progress. Wait with jobs_wait (timeout_seconds <= 15); do not call show_generation_by_ids or job_display again unless the user requests a separate display. After comple…",{"_409":410,"_411":4253,"_413":414,"_433":4254,"_417":418},{"_406":3971,"_53":3972},{"_1448":4256,"_4255":4257,"_4258":4259},[1448,4255],"max_credits",{"_409":410,"_411":4260,"_433":4261},{"_409":1006,"_493":38},"use_free_gens",{"_409":1097},{"_4262":4266,"_4263":4267,"_4264":4268,"_4265":4269,"_4270":4271,"_4272":4273,"_4274":4275,"_4276":4277,"_4278":4279,"_4280":4281},[4262,4263,4264,4265],"tier","selection","brief","medias",{"_409":442,"_465":4401},{"_409":410,"_3586":4398,"_417":4399},{"_409":442,"_974":4130},{"_595":30,"_409":596,"_597":4388},"item_medias",{"_595":4374,"_409":596,"_597":4375},"batch_size",{"_409":492,"_493":30,"_494":4295},"seed",{"_409":492,"_493":30,"_494":4055},"body_color",{"_409":442,"_1119":4373},"animal_variant",{"_4316":4317},"trait_variants",{"_409":410,"_411":4282,"_433":4283,"_417":418},{"_4284":4286,"_4285":4287,"_4288":4289},[4284,4285],"version","choices",{"_409":442,"_4314":4315},{"_409":410,"_3586":4296,"_417":4297},"animal_choices",{"_614":4290},[4291,4292],{"_409":410,"_3586":4293,"_417":4294},{"_409":1462},{"_409":442},{"_409":492,"_493":38,"_494":4295},4,{"_409":442},{"_614":4298},[4299,4300],{"_409":442,"_465":4312},{"_409":442,"_465":4301},[4302,4303,4304,4305,4306,4307,4308,4309,4310,4311],"v1","v2","v3","v4","v5","v6","v7","v8","v9","v10",[4313,4302,4303,4304,4305,4306],"original","const","appearance-v2","oneOf",[4318,4319],{"_409":410,"_411":4365,"_433":4366,"_417":418},{"_409":410,"_411":4320,"_433":4321,"_417":418},{"_4284":4323,"_4262":4324,"_406":4325,"_4322":4326},[4284,4262,406,4322],"look",{"_409":442,"_4314":4364},{"_409":442,"_465":4357},{"_409":442,"_1119":4356},{"_409":410,"_411":4327,"_433":4328,"_417":418},{"_474":4335,"_4329":4336,"_4330":4337,"_4331":4338,"_4332":4339,"_4333":4340,"_4334":4341},[474,4329,4330,4331,4332,4333,4334],"hair","build","height","proportions","gender","aesthetic",{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_465":4351},{"_409":442,"_465":4342},[4343,4344,4345,4346,4347,4348,4349,4350],"casual","sporty","streetstyle","y2k","retro","goth","theatrical","suits",[4352,4353,4354],"male","female","non_binary",20000,"^[a-z][a-z0-9_]{0,63}$",[4358,4359,4360,4361,4362,4363],"insects","frogs","cats","dogs","capybaras","birds","animals-v3",{"_4284":4367,"_4262":4368,"_406":4369,"_4322":4370},[4284,4262,406],{"_409":442,"_4314":4372},{"_409":442,"_465":4371},{"_409":442,"_1119":4356},{"_409":1462},[4358,4359,4360,4361,4362,4363],"animals-v1","^#[\\dA-F]{6}$",3,{"_409":410,"_411":4376,"_433":4377},{"_4378":4379,"_1474":4380},[4378,1474],"role",{"_409":442,"_4314":3899},{"_409":410,"_411":4381,"_433":4382},{"_406":4383,"_409":4384},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4385},[4386,4387],"media_input","image_job",{"_409":410,"_411":4389,"_433":4390},{"_4378":4391,"_1474":4392},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4393,"_433":4394},{"_406":4395,"_409":4396},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4397},[4386,4387],{"_409":442},{"_595":4295,"_409":596,"_597":4400},{"_409":442},[4402,4403,4404,4358,4359,4360,4361,4362,4363],"normal","freak","total","higgsfield_ai_influencer_prepare","Ai influencer prepare","Prepare an AI Influencer character design and quote the total credit cost for batch_size (one to four sheets, default one) without creating a job or spending credits. Accepts human or animal tiers, traits, brief, seed, at most one confirmed identity image in medias and up to three Style references in item_medias. Preserves animal-v3 look and animal trait choices from saved settings; FNF validates variant IDs against the current catalog. Default randomize=true fills unspecified traits using builder shuffle rules; reference identity traits stay unset unless explicitly selected. randomize=false preserves explicit settings and defaults tier to freak (Bold). Returns exact params, credits and free_gens_remaining when known. For generation, pass these params unchanged to ai_influencer_generate; preview-only requests stop here. Repeating preparation may produce a different random design.",{"_409":410,"_411":4410,"_413":414,"_417":418},{"_406":3971,"_53":3972},{"_4262":4411,"_4263":4412,"_4264":4413,"_4274":4414,"_4265":4415,"_4270":4416,"_4276":4417,"_4278":4418,"_4280":4419,"_4272":4420,"_4421":4422},{"_409":442,"_465":4491},{"_409":410,"_3586":4488,"_417":4489},{"_409":442,"_974":4130},{"_409":492,"_493":30,"_494":4055},{"_595":30,"_409":596,"_597":4478},{"_595":4374,"_409":596,"_597":4468},{"_409":442,"_1119":4373},{"_4316":4440},{"_409":410,"_411":4423,"_433":4424,"_417":418},{"_409":492,"_493":30,"_494":4295},"randomize",{"_409":1097},{"_4284":4425,"_4285":4426,"_4288":4427},[4284,4285],{"_409":442,"_4314":4315},{"_409":410,"_3586":4433,"_417":4434},{"_614":4428},[4429,4430],{"_409":410,"_3586":4431,"_417":4432},{"_409":1462},{"_409":442},{"_409":492,"_493":38,"_494":4295},{"_409":442},{"_614":4435},[4436,4437],{"_409":442,"_465":4439},{"_409":442,"_465":4438},[4302,4303,4304,4305,4306,4307,4308,4309,4310,4311],[4313,4302,4303,4304,4305,4306],[4441,4442],{"_409":410,"_411":4461,"_433":4462,"_417":418},{"_409":410,"_411":4443,"_433":4444,"_417":418},{"_4284":4445,"_4262":4446,"_406":4447,"_4322":4448},[4284,4262,406,4322],{"_409":442,"_4314":4364},{"_409":442,"_465":4460},{"_409":442,"_1119":4356},{"_409":410,"_411":4449,"_433":4450,"_417":418},{"_474":4451,"_4329":4452,"_4330":4453,"_4331":4454,"_4332":4455,"_4333":4456,"_4334":4457},[474,4329,4330,4331,4332,4333,4334],{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_465":4459},{"_409":442,"_465":4458},[4343,4344,4345,4346,4347,4348,4349,4350],[4352,4353,4354],[4358,4359,4360,4361,4362,4363],{"_4284":4463,"_4262":4464,"_406":4465,"_4322":4466},[4284,4262,406],{"_409":442,"_4314":4372},{"_409":442,"_465":4467},{"_409":442,"_1119":4356},{"_409":1462},[4358,4359,4360,4361,4362,4363],{"_409":410,"_411":4469,"_433":4470},{"_4378":4471,"_1474":4472},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4473,"_433":4474},{"_406":4475,"_409":4476},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4477},[4386,4387],{"_409":410,"_411":4479,"_433":4480},{"_4378":4481,"_1474":4482},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4483,"_433":4484},{"_406":4485,"_409":4486},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4487},[4386,4387],{"_409":442},{"_595":4295,"_409":596,"_597":4490},{"_409":442},[4402,4403,4404,4358,4359,4360,4361,4362,4363],"higgsfield_ai_influencer_get_settings","Ai influencer get settings","Read reusable settings from an existing AI Influencer sheet using its job_id. Returns human or animal traits, identity and Style references, body color and saved appearance variants when present. Does not replay the original batch count, quote, save or generate an image. Pass returned params to ai_influencer_prepare with randomize=false to preserve the design.",{"_409":410,"_411":4497,"_413":414,"_433":4498,"_417":418},{"_406":3971,"_53":3972},{"_4499":4500},[4499],"job_id",{"_409":442,"_1117":3481,"_1119":3482},"higgsfield_ai_influencer_list_presets","Ai influencer list presets","Browse AI Influencer character-sheet presets with previews and reusable settings. Does not generate a sheet. Pass selected preset settings to ai_influencer_prepare with randomize=false.",{"_409":410,"_411":4506,"_413":414,"_417":418},{"_406":3971,"_53":3972},{"_4030":4507,"_1002":4508,"_3993":4509},{"_409":442,"_1117":3481,"_1119":3482},{"_396":4054,"_409":492,"_493":30,"_494":4055},{"_396":4053,"_409":492,"_493":30,"_494":516},"higgsfield_ai_influencer_get_options","Ai influencer get options","List available AI Influencer character traits for human and animal tiers. Optionally filter by tier; returns option IDs and tier constraints for ai_influencer_prepare. Does not randomize, quote, create or save a character.",{"_409":410,"_411":4515,"_413":414,"_417":418},{"_406":3971,"_53":3972},{"_4262":4516},{"_409":442,"_465":4517},[4402,4403,4404,4358,4359,4360,4361,4362,4363],"higgsfield_build_ai_influencer","Build ai influencer","Create one to four AI Influencer character sheets in chat using the builder backend, without training a Soul. Not for text-only concepts or opening the builder UI. options lists traits; presets browses character presets; recreate loads a sheet job's settings without generating. quote accepts tier, selection, brief, seed, batch_size (one to four), up to one confirmed identity reference in medias and up to three Style references in item_medias. Animal v3 look and trait choices from saved settings are preserved. Default randomize=true fills unspecified traits using the UI shuffle rules; randomize=false keeps only explicit choices and defaults tier to freak (Bold). With a reference, identity groups stay unset unless explicitly chosen. To reuse preset/recreate params, spread them into quote with randomize=false. Quote returns exact params, credits and free_gens_remaining when known. Report design and price, respect preview-only requests and budgets. Only submit starts a generation job and saves its character shee…",{"_409":410,"_413":414,"_4316":4523},{"_406":3971,"_53":3972},[4524,4525,4526,4527,4528],{"_409":410,"_411":4712,"_433":4713},{"_409":410,"_411":4706,"_433":4707},{"_409":410,"_411":4701,"_433":4702},{"_409":410,"_411":4617,"_433":4618},{"_409":410,"_411":4529,"_433":4530},{"_3467":4531,"_1448":4532,"_4255":4533,"_4258":4534},[3467,1448,4255],{"_409":442,"_4314":4616},{"_409":410,"_411":4535,"_433":4536},{"_409":1006,"_493":38},{"_409":1097},{"_4262":4537,"_4263":4538,"_4264":4539,"_4265":4540,"_4270":4541,"_4272":4542,"_4274":4543,"_4276":4544,"_4278":4545,"_4280":4546},[4262,4263,4264,4265],{"_409":442,"_465":4615},{"_409":410,"_3586":4612,"_417":4613},{"_409":442,"_974":4130},{"_595":30,"_409":596,"_597":4602},{"_595":4374,"_409":596,"_597":4592},{"_409":492,"_493":30,"_494":4295},{"_409":492,"_493":30,"_494":4055},{"_409":442,"_1119":4373},{"_4316":4564},{"_409":410,"_411":4547,"_433":4548,"_417":418},{"_4284":4549,"_4285":4550,"_4288":4551},[4284,4285],{"_409":442,"_4314":4315},{"_409":410,"_3586":4557,"_417":4558},{"_614":4552},[4553,4554],{"_409":410,"_3586":4555,"_417":4556},{"_409":1462},{"_409":442},{"_409":492,"_493":38,"_494":4295},{"_409":442},{"_614":4559},[4560,4561],{"_409":442,"_465":4563},{"_409":442,"_465":4562},[4302,4303,4304,4305,4306,4307,4308,4309,4310,4311],[4313,4302,4303,4304,4305,4306],[4565,4566],{"_409":410,"_411":4585,"_433":4586,"_417":418},{"_409":410,"_411":4567,"_433":4568,"_417":418},{"_4284":4569,"_4262":4570,"_406":4571,"_4322":4572},[4284,4262,406,4322],{"_409":442,"_4314":4364},{"_409":442,"_465":4584},{"_409":442,"_1119":4356},{"_409":410,"_411":4573,"_433":4574,"_417":418},{"_474":4575,"_4329":4576,"_4330":4577,"_4331":4578,"_4332":4579,"_4333":4580,"_4334":4581},[474,4329,4330,4331,4332,4333,4334],{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_465":4583},{"_409":442,"_465":4582},[4343,4344,4345,4346,4347,4348,4349,4350],[4352,4353,4354],[4358,4359,4360,4361,4362,4363],{"_4284":4587,"_4262":4588,"_406":4589,"_4322":4590},[4284,4262,406],{"_409":442,"_4314":4372},{"_409":442,"_465":4591},{"_409":442,"_1119":4356},{"_409":1462},[4358,4359,4360,4361,4362,4363],{"_409":410,"_411":4593,"_433":4594},{"_4378":4595,"_1474":4596},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4597,"_433":4598},{"_406":4599,"_409":4600},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4601},[4386,4387],{"_409":410,"_411":4603,"_433":4604},{"_4378":4605,"_1474":4606},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4607,"_433":4608},{"_406":4609,"_409":4610},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4611},[4386,4387],{"_409":442},{"_595":4295,"_409":596,"_597":4614},{"_409":442},[4402,4403,4404,4358,4359,4360,4361,4362,4363],"submit",{"_3467":4619,"_4262":4620,"_4263":4621,"_4264":4622,"_4274":4623,"_4265":4624,"_4270":4625,"_4276":4626,"_4278":4627,"_4280":4628,"_4272":4629,"_4421":4630},[3467],{"_409":442,"_4314":4700},{"_409":442,"_465":4699},{"_409":410,"_3586":4696,"_417":4697},{"_409":442,"_974":4130},{"_409":492,"_493":30,"_494":4055},{"_595":30,"_409":596,"_597":4686},{"_595":4374,"_409":596,"_597":4676},{"_409":442,"_1119":4373},{"_4316":4648},{"_409":410,"_411":4631,"_433":4632,"_417":418},{"_409":492,"_493":30,"_494":4295},{"_409":1097},{"_4284":4633,"_4285":4634,"_4288":4635},[4284,4285],{"_409":442,"_4314":4315},{"_409":410,"_3586":4641,"_417":4642},{"_614":4636},[4637,4638],{"_409":410,"_3586":4639,"_417":4640},{"_409":1462},{"_409":442},{"_409":492,"_493":38,"_494":4295},{"_409":442},{"_614":4643},[4644,4645],{"_409":442,"_465":4647},{"_409":442,"_465":4646},[4302,4303,4304,4305,4306,4307,4308,4309,4310,4311],[4313,4302,4303,4304,4305,4306],[4649,4650],{"_409":410,"_411":4669,"_433":4670,"_417":418},{"_409":410,"_411":4651,"_433":4652,"_417":418},{"_4284":4653,"_4262":4654,"_406":4655,"_4322":4656},[4284,4262,406,4322],{"_409":442,"_4314":4364},{"_409":442,"_465":4668},{"_409":442,"_1119":4356},{"_409":410,"_411":4657,"_433":4658,"_417":418},{"_474":4659,"_4329":4660,"_4330":4661,"_4331":4662,"_4332":4663,"_4333":4664,"_4334":4665},[474,4329,4330,4331,4332,4333,4334],{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_497":30,"_974":4355},{"_409":442,"_465":4667},{"_409":442,"_465":4666},[4343,4344,4345,4346,4347,4348,4349,4350],[4352,4353,4354],[4358,4359,4360,4361,4362,4363],{"_4284":4671,"_4262":4672,"_406":4673,"_4322":4674},[4284,4262,406],{"_409":442,"_4314":4372},{"_409":442,"_465":4675},{"_409":442,"_1119":4356},{"_409":1462},[4358,4359,4360,4361,4362,4363],{"_409":410,"_411":4677,"_433":4678},{"_4378":4679,"_1474":4680},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4681,"_433":4682},{"_406":4683,"_409":4684},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4685},[4386,4387],{"_409":410,"_411":4687,"_433":4688},{"_4378":4689,"_1474":4690},[4378,1474],{"_409":442,"_4314":3899},{"_409":410,"_411":4691,"_433":4692},{"_406":4693,"_409":4694},[406,409],{"_409":442,"_1117":3481,"_1119":3482},{"_409":442,"_465":4695},[4386,4387],{"_409":442},{"_595":4295,"_409":596,"_597":4698},{"_409":442},[4402,4403,4404,4358,4359,4360,4361,4362,4363],"quote",{"_3467":4703,"_4499":4704},[3467,4499],{"_409":442,"_4314":4705},{"_409":442,"_1117":3481,"_1119":3482},"recreate",{"_3467":4708,"_1002":4709,"_3993":4710},[3467],{"_409":442,"_4314":4711},{"_409":492,"_493":30,"_494":4055},{"_409":492,"_493":30,"_494":516},"presets",{"_3467":4714,"_4262":4715},[3467],{"_409":442,"_4314":4717},{"_409":442,"_465":4716},[4402,4403,4404,4358,4359,4360,4361,4362,4363],"options","higgsfield_show_characters","Show characters","Soul Characters widget — reusable trained identity models. Actions: `list` (browse), `train` (needs `name` + 5-20 ref images, ~10 min, non-blocking — widget polls), `status` (inspect by `soul_id`). Presence of `name`/`images`/`medias` ⇒ train mode. Call `train` only on explicit ask for a reusable Soul / digital twin / identity, or when 5+ ref photos are supplied. Ref images accept: media_id UUIDs from media_confirm, completed image-job IDs, or https URLs. Never local paths — upload via media_upload → PUT bytes → media_confirm first. CONSTRAINTS: - Trained Soul is usable ONLY with `soul_2` (Soul V2) and `soul_cinematic` (Soul Cinema). For any other model, the user needs `show_reference_elements`. - ONE soul_id per generation. Multi-character shots ('me + friend', 'two people') must use `show_reference_elements` (supports multiple `<<>>` placeholders). AMBIGUITY GUARD — character/avatar/digital-twin/'use my face' requests without a chosen path: do NOT call this tool yet; ask the user to pick: 1. Train So…",{"_409":410,"_411":4723,"_413":414},{"_406":3971,"_53":3972},{"_3467":4724,"_409":4725,"_53":4726,"_4727":4728,"_4265":4729,"_4730":4731,"_35":4732,"_1002":4733,"_3993":4734},{"_396":4757,"_409":442},{"_415":4752,"_396":4753,"_409":442,"_465":4754},{"_396":4751,"_409":442},"images",{"_396":4749,"_409":596,"_597":4750},{"_396":4742,"_409":596,"_597":4743},"soul_id",{"_396":4741,"_409":442},{"_396":4737,"_409":442,"_465":4738},{"_396":4736,"_409":1006},{"_396":4735,"_415":3509,"_409":492,"_493":30,"_494":516},"Number of characters per page.","Pagination cursor from previous response's next_cursor.","List filter. Use ready to find characters available for generation.",[4739,4740,683],"ready","training","Character id for action=status.","Chat media references to resolve as training images for action=train. Values may be media_id UUIDs, completed image generation job IDs, or https image URLs.",{"_409":410,"_411":4744,"_433":4745},{"_1091":4746,"_4378":4747},[1091],{"_409":442,"_396":4748},{"_415":3899,"_409":442,"_4314":3899},"For Soul training: returned media_id UUID from media_confirm, a completed image generation job ID, or an https image URL. Do not pass local file paths like /mnt/user-data/uploads/...; upload/confirm first and use the media_id UUID.","For Soul training: returned media_id UUIDs from media_confirm, completed image generation job IDs, or https image URLs. Required with medias to total 5-20 images for action=train. Do not pass local file paths.",{"_409":442},"Character name, required for action=train.","soul_2","Character type. Use soul_2 for model='soul_2'; use soul_cinematic for model='soul_cinematic'; use soul for legacy Soul references.",[4755,4752,4756],"soul","soul_cinematic","Mode selector: list, train/create, or status/get.","higgsfield_sandbox_exec","Sandbox exec","Execute a shell command in a remote Higgsfield cloud Linux sandbox — NOT your local machine or the client's own shell. Use it for Higgsfield media workflows and website_repo_access checkouts that require the hosted toolchain. Do not use it to inspect a local repository, install desktop software, or control applications on the user's computer. Preinstalled: ffmpeg/ffprobe, ImageMagick, sox, python3 with Pillow and faster-whisper, node/npm/npx, sharp-cli, Playwright with headless Chromium, caption fonts (Metropolis, Montserrat), zip/unzip, git, curl, jq. Use it for media processing (trim, convert, overlay, concat with ffmpeg), image manipulation, and packaging that dedicated Higgsfield tools do not cover. The sandbox is isolated per user and is discarded ~10 seconds after a call finishes, so files in /home/user only survive between back-to-back calls — chain multi-step work into a single command (&&) and export results before finishing, or expect to re-download inputs. It has internet access: bring files in wi…",{"_409":410,"_411":4763,"_413":414,"_433":4764},{"_406":3971,"_53":3972},{"_3319":4765,"_4766":4767,"_4768":4769,"_4770":4771,"_4772":4773},[3319],{"_409":442,"_497":30,"_974":4780,"_396":4781},"timeout_seconds",{"_396":4779,"_409":492,"_493":30,"_494":4043},"background",{"_396":4778,"_409":1097},"restart",{"_396":4777,"_409":1097},"image_paths",{"_396":4774,"_594":30,"_595":4295,"_409":596,"_597":4775},"PNG/JPEG files to return as native images after a successful foreground command. All image files together must be <=512 KiB; split larger sets across calls. Relative paths start at /home/user. Inspect the actual images before writing visual review verdicts.",{"_409":442,"_497":30,"_974":4776},1024,"Discard the current sandbox (all files and processes) and start a fresh one before running the command.","Run the command detached and return immediately with a pid, log_path, and status_path. Poll with a later sandbox_exec call; stop with kill .","Seconds before the command is killed (default 60, max 120). Ignored with background:true.",16000,"Shell command to run (bash). Runs in the persistent per-user sandbox.","higgsfield_ads_studio_card","Ads studio card","What the Ads Studio card shows: brands, one brand, products or one product. Used by the card.",{"_409":410,"_411":4787,"_413":414,"_433":4788},{"_406":3971,"_53":3972},{"_99":4789,"_4790":4791,"_4792":4793,"_4794":4795,"_4796":4797,"_4798":4799,"_1002":4800},[99],{"_409":442,"_465":4802},"brand_id",{"_409":442,"_1117":3481,"_1119":3482},"product_id",{"_409":442,"_1117":3481,"_1119":3482},"product_ids",{"_595":3943,"_409":596,"_597":4801},"include_unpicked",{"_409":1097},"include_products",{"_409":1097},{"_409":442},{"_409":442,"_1117":3481,"_1119":3482},[4803,4804,4805,4806],"brands","brand","products","product","higgsfield_ads_studio_run_progress","Ads studio run progress","Progress of one Ads Studio generation run. Used by the generation card.",{"_409":410,"_411":4812,"_413":414,"_433":4813},{"_406":3971,"_53":3972},{"_4814":4815},[4814],"run_id",{"_409":442,"_1117":3481,"_1119":3482},"higgsfield_ads_studio_cancel_run","Ads studio cancel run","Cancel a queued or running Ads Studio generation. Pictures already rendered stay; a run too far along to stop answers that it can no longer be canceled. Only cancel when the user asks.",{"_409":410,"_411":4821,"_413":414,"_433":4822},{"_406":3971,"_53":3972},{"_4814":4823},[4814],{"_409":442,"_1117":3481,"_1119":3482,"_396":4824},"Run id from ads_studio_generate or ads_studio_list_runs.","higgsfield_ads_studio_generate","Ads studio generate","Generate ad creatives in Ads Studio: for a brand, for products of any brand or of none, or from a prompt and the user's pictures alone, with or without the brand kit. Ads Studio writes the concepts and renders the pictures. This spends Higgsfield credits, so quote with ads_studio_quote and get explicit approval of the exact allocation and credit cost first. An approval from the Ads Studio app allocation is NOT approval. When allocation is supplied, this tool quotes the whole allocation and requests native MCP form confirmation when supported. Otherwise it returns approval_required and credits: show the exact counts and cost, ask for explicit chat approval and stop. Only after approval, repeat the unchanged allocation with expected_credits. Never split the allocation or bypass a supported native form. Answers as soon as the runs are accepted, with a run id each - report those and stop; read ads_studio_get_run when the user asks, never in a loop. Generation takes a few minutes.",{"_409":410,"_411":4830,"_413":414,"_433":4831},{"_406":3971,"_53":3972},{"_4790":4833,"_4834":4835,"_4794":4836,"_4837":4838,"_4404":4839,"_4840":4841,"_4727":4842,"_4843":4844,"_4845":4846,"_4847":4848,"_4849":4850,"_4832":4851},[4832],"idempotency_key",{"_396":4892,"_409":442,"_1117":3481,"_1119":3482},"brand_kit",{"_396":4891,"_409":1097},{"_396":4889,"_595":4855,"_409":596,"_597":4890},"include_brand",{"_396":4888,"_409":1097},{"_396":4887,"_409":492,"_493":30,"_494":516},"prompt",{"_396":4886,"_409":442,"_974":975},{"_396":4877,"_595":4295,"_409":596,"_597":4878},"objective",{"_396":4870,"_409":442,"_465":4871},"aspect_ratio",{"_415":4864,"_396":4865,"_409":442,"_465":4866},"allocation",{"_396":4854,"_594":30,"_595":4855,"_409":596,"_597":4856},"expected_credits",{"_396":4853,"_409":1006,"_493":38},{"_409":442,"_497":30,"_974":3980,"_396":4852},"A key you choose once for this generation and repeat unchanged if you have to retry. Never invent a new one for a retry: that buys the same batch a second time.","Exact credit cost explicitly approved by the user in chat. The server requotes before spending and refuses a changed price. For an app allocation on a host without native form support, preserve the exact allocation and key. Omit for native confirmation.","Exact per-product counts from the Ads Studio app. Submit the whole allocation in one call, with brand_id, aspect_ratio and one stable idempotency_key. The first call quotes and requests approval without spending. Do not combine with product_ids, total, prompt, images, objective, include_brand or brand_kit. Chat-approved retries require expected_credits equal to the approved total cost.",24,{"_409":410,"_411":4857,"_433":4858,"_417":418},{"_4792":4859,"_507":4860,"_53":4861},[4792,507],{"_409":442,"_1117":3481,"_1119":3482},{"_409":492,"_493":30,"_494":3943},{"_396":4862,"_409":442,"_974":4863},"Display label only; authorization and allocation use product_id.",300,"1:1","The frame for the whole batch: 1:1 square feed, 9:16 stories and reels, 16:9 landscape, 3:4 portrait feed. 4:5 is not available - offer 3:4 as the nearest portrait frame.",[4864,4867,4868,4869],"9:16","16:9","3:4","What the ads are for. Set it only when the user made the goal clear (more sales -> sales; sign-ups, demos, quotes -> leads; visits, clicks -> traffic; a launch or being known -> awareness; comments, shares -> engagement). Left out, the product's own profile decides.",[4872,4873,4874,4875,4876],"sales","leads","engagement","traffic","awareness","Pictures the user supplied for this generation: inspiration or photos of their product.",{"_409":410,"_411":4879,"_433":4880},{"_1894":4881,"_4378":4882},[1894],{"_409":442,"_1117":4177,"_396":4885},{"_396":4883,"_409":442,"_465":4884},"style (default): a look to follow. product: a photo of the thing being advertised.",[3221,4806],"A public https link to the picture.","What the user asked for in their own words: the angle, the offer, the audience. A prompt alone, with no product and no brand, is an ad about what it describes.","How many concepts in total across all subjects: the number the user named, or 1 for a singular request. Ads Studio splits it between the subjects, so it must be at least one per subject.","Also generate a run about the brand itself, not a single product. Needs brand_id and the kit on.","Products to advertise, from ads_studio_list_products - of this brand, another brand or none; each gets its own run. Name at least one product, or set include_brand, or give a prompt - with none of them there is nothing to advertise.",{"_409":442,"_1117":3481,"_1119":3482},"false to make the ads without the brand kit even though brand_id is set: a plain product or prompt ad. Default true when brand_id is set; always off without one.","The brand whose kit (logo, palette, tone) shapes the ads, from ads_studio_list_brands. Leave it out to make ads with no brand kit at all. The kit only reaches this brand's own products: a product of another brand, or of none, is advertised without it, so never promise the user this brand's look on someone else's product.","higgsfield_ads_studio_quote","Ads studio quote","Get the cost without starting a generation, reserving credits or spending credits. A user request to create ads, including an exact allocation submitted from the Ads Studio app, authorizes this read-only quote: do not ask for separate permission to quote. Takes the same arguments as ads_studio_generate so the quote matches the run. After quoting a requested generation, show the exact allocation and total credits; use ask_user_input (or ask_user_input_v3) only when that exact host tool is available, otherwise ask one concise chat question. Never invent a host tool or generate before explicit approval of this allocation and cost. A price-only request needs only the quote, not a spending-approval question.",{"_409":410,"_411":4898,"_413":414},{"_406":3971,"_53":3972},{"_4790":4899,"_4834":4900,"_4794":4901,"_4837":4902,"_4404":4903,"_4840":4904,"_4727":4905,"_4843":4906,"_4845":4907},{"_396":4892,"_409":442,"_1117":3481,"_1119":3482},{"_396":4891,"_409":1097},{"_396":4889,"_595":4855,"_409":596,"_597":4916},{"_396":4888,"_409":1097},{"_396":4887,"_409":492,"_493":30,"_494":516},{"_396":4886,"_409":442,"_974":975},{"_396":4877,"_595":4295,"_409":596,"_597":4910},{"_396":4870,"_409":442,"_465":4909},{"_415":4864,"_396":4865,"_409":442,"_465":4908},[4864,4867,4868,4869],[4872,4873,4874,4875,4876],{"_409":410,"_411":4911,"_433":4912},{"_1894":4913,"_4378":4914},[1894],{"_409":442,"_1117":4177,"_396":4885},{"_396":4883,"_409":442,"_465":4915},[3221,4806],{"_409":442,"_1117":3481,"_1119":3482},"higgsfield_ads_studio_update_product","Ads studio update product","Change one Ads Studio product, or hide it from the brand page. picked_for_ads=false hides it and true shows it again; neither deletes anything, and a generation still advertises exactly the products it names. Every other field is a merge patch: what you leave out is left alone. Use the user's own words for the copy fields; do not invent selling points they did not say.",{"_409":410,"_411":4922,"_413":414,"_433":4923},{"_406":3971,"_53":3972},{"_4790":4924,"_4792":4925,"_4926":4927,"_53":4928,"_4929":4930,"_4727":4931,"_396":4932,"_4933":4934,"_3496":4935,"_4936":4937,"_4938":4939},[4790,4792],{"_409":442,"_1117":3481,"_1119":3482,"_396":4963},{"_409":442,"_1117":3481,"_1119":3482,"_396":4962},"picked_for_ads",{"_396":4961,"_409":1097},{"_409":442,"_974":2859},"custom_name",{"_396":4960,"_409":442,"_974":516},{"_396":4958,"_595":4295,"_409":596,"_597":4959},{"_614":4955},"price",{"_396":4951,"_614":4952},{"_396":4947,"_614":4948},"audience",{"_396":4943,"_614":4944},"selling_points",{"_396":4940,"_595":4941,"_409":596,"_597":4942},"Replaces the whole list.",12,{"_409":442,"_974":4863},"Who it is for, when the user says.",[4945,4946],{"_409":442,"_974":3797},{"_409":1462},"The product's own page.",[4949,4950],{"_409":442,"_1117":4177},{"_409":1462},"As the user says it, e.g. \"$90\" or \"from 4 900 RUB\".",[4953,4954],{"_409":442,"_974":516},{"_409":1462},[4956,4957],{"_409":442,"_974":4130},{"_409":1462},"Replace product pictures with up to four existing or confirmed uploaded image URLs.",{"_409":442,"_1117":4177},"User-edited display title; empty clears the override.","False hides the product from the brand page, true shows it. Nothing is deleted or created.","Product id from ads_studio_list_products.","The brand that owns this product.","higgsfield_ads_studio_add_product","Ads studio add product","Add a product to Ads Studio - under a brand, or with no brand at all - from its page link and/or a pasted description. Answers as soon as the row is queued - Ads Studio reads the page in the background. Do not poll and do not list products to check. Read ads_studio_get_product when the user asks about it. Use this when the research missed a product or the user names a new one. To refresh an existing product from its page, pass its id in overwrite instead of adding a second row.",{"_409":410,"_411":4969,"_413":414},{"_406":3971,"_53":3972},{"_4790":4970,"_1894":4971,"_1893":4972,"_4727":4973,"_4974":4975},{"_396":4982,"_409":442,"_1117":3481,"_1119":3482},{"_396":4981,"_409":442,"_1117":4177},{"_396":4980,"_409":442,"_974":4130},{"_396":4978,"_595":3921,"_409":596,"_597":4979},"overwrite",{"_396":4976,"_595":3943,"_409":596,"_597":4977},"Existing product ids to refresh from the page instead of creating a new row.",{"_409":442,"_1117":3481,"_1119":3482},"Product photo URLs the user supplied or uploaded. Ads Studio fetches each one, so a link it cannot reach is refused.",{"_409":442,"_1117":4177},"The user's own description, when there is no page or it adds facts the page lacks.","The product's own page. Give this whenever the user has it: it is what makes the ads specific.","The brand this product belongs to, from ads_studio_list_brands. Leave it out for a product of no brand: it is still listed by ads_studio_list_products without brand_id and can be generated.","higgsfield_ads_studio_create_brand","Ads studio create brand","Research a brand from its website and build its Ads Studio brand profile: products, palette, logo, tone and audience, read from the live site. Pass the website when you have it - with a URL the research starts at once and takes a few minutes; with only a name Ads Studio answers with the site it thinks was meant and starts nothing, so confirm that with the user and call again with the URL. This reads the brand's own public website. It does not design logos or brand assets (that is the brand-asset-creation workflow) and it is not the Marketing Studio brand-kit record (marketing_create_brand_kit). Before the first Ads Studio call in a conversation, load the 'ads-studio' workflow with get_workflow_instructions.",{"_409":410,"_411":4988,"_413":414,"_433":4989},{"_406":3971,"_53":3972},{"_4990":4991},[4990],"input",{"_409":442,"_497":30,"_974":975,"_396":4992},"The brand's website URL, or its name if the user has not given a URL.","higgsfield_ads_studio_get_run","Ads studio get run","Read one Ads Studio generation run: its status and every concept in it, with the ad copy. Opens the generation card, which shows the pictures - there is no image link in the result and none to ask for. Call it when the user asks about a run - never on your own initiative and never in a loop. A run can read done while its pictures are still rendering, so check still_rendering before telling the user the ads are ready. A queued run carries its place in line; a canceled run stays canceled and is not a failure. Name a creative by its concept_id. These pictures are not ordinary generations: do not pass Ads Studio ids to show_generation_by_ids or jobs_wait.",{"_409":410,"_411":4998,"_413":414,"_433":4999},{"_406":3971,"_53":3972},{"_4814":5000},[4814],{"_409":442,"_1117":3481,"_1119":3482,"_396":4824},"higgsfield_ads_studio_list_runs","Ads studio list runs","List recent Ads Studio generation runs, newest first, optionally for one brand. Use it to find a run whose id was lost, or to check what is already in flight before starting another batch.",{"_409":410,"_411":5006,"_413":414},{"_406":3971,"_53":3972},{"_4790":5007,"_1000":5008},{"_409":442,"_1117":3481,"_1119":3482,"_396":5010},{"_396":5009,"_409":492,"_493":30,"_494":3796},"How many runs to return; default 20.","Ads Studio brand id, from ads_studio_list_brands or ads_studio_create_brand.","higgsfield_ads_studio_get_product","Ads studio get product","Read one Ads Studio product and open it as a card: whether Ads Studio has finished reading its page (status queued, in_progress, completed or failed, with fail_reason when it failed) and what it knows - name, price, page, description, selling points. Use this to answer \"is the product ready?\" after ads_studio_add_product, when the user asks - not on a timer and never in a loop.",{"_409":410,"_411":5016,"_413":414,"_433":5017},{"_406":3971,"_53":3972},{"_4792":5018},[4792],{"_409":442,"_1117":3481,"_1119":3482,"_396":5019},"Product id from ads_studio_add_product or ads_studio_list_products.","higgsfield_ads_studio_list_products","Ads studio list products","List Ads Studio products and open them as a card the user can browse: name, price, page, how many pictures it has, whether the brand page shows it (picked_for_ads) and whether its ad copy is ready. With brand_id: that brand's products. Without it: every product the user has - of any brand or of none - a page at a time. Use product_id in ads_studio_quote and ads_studio_generate: a generation advertises exactly the products named there, whatever picked_for_ads says. texts_ready=false means the copy is still being written and ads made from it come out weaker.",{"_409":410,"_411":5025,"_413":414},{"_406":3971,"_53":3972},{"_4790":5026,"_4796":5027,"_1002":5028},{"_409":442,"_1117":3481,"_1119":3482,"_396":5010},{"_396":5030,"_409":1097},{"_396":5029,"_409":442},"Without brand_id: next_cursor from the previous page, unchanged.","With brand_id: include products hidden from the brand page (default true).","higgsfield_ads_studio_get_brand","Ads studio get brand","Read one Ads Studio brand: how far its research got through the five stages (gather, synthesis, enrichment, products, assets) and what is already usable. Use this to answer \"is the research done?\" - status done means the brand and its products are ready. Call it when the user asks, not on a timer, and never in a loop: research can take several minutes. Follow next_step: a finished research is offered for ads, never generated on its own.",{"_409":410,"_411":5036,"_413":414,"_433":5037},{"_406":3971,"_53":3972},{"_4790":5038},[4790],{"_409":442,"_1117":3481,"_1119":3482,"_396":5010},"higgsfield_ads_studio_list_brands","Ads studio list brands","List the brands in this account's Higgsfield Ads Studio, with each one's research status and how many products it has, and open them as a card the user can browse. Call this when the user talks about advertising an existing brand, so later tools get a real brand_id; when the list is already in this conversation, reuse its ids instead of listing again. This is Ads Studio, the ad-creative workspace: it is not the Marketing Studio brand-kit record (marketing_list_brand_kits) and it does not create or design brand assets. Before the first Ads Studio call in a conversation, load the 'ads-studio' workflow with get_workflow_instructions: it carries the frames, objectives and the research-then-offer flow.",{"_409":410,"_411":5044,"_413":414},{"_406":3971,"_53":3972},{},"higgsfield_apps_invoke","Apps invoke","Run one described action on a Marketplace app AS the current user. First call apps_describe(app_id, action) to get the exact `arguments` schema and the `manifest_revision`, then pass them here. Long-running actions return { id, status: \"queued\" }. If a widget is visible, it polls the status action automatically — do not re-invoke get_* as a follow-up poll. In text-only clients, poll by invoking the app's status action (e.g. get_render) until status is completed/failed. The action's own annotations (from apps_describe) indicate cost/side-effects; confirm with the user before an expensive or destructive action.",{"_409":410,"_411":5050,"_413":414,"_433":5051},{"_406":3971,"_53":3972},{"_5052":5054,"_3467":5055,"_5056":5057,"_5053":5058},[5052,3467,5053],"app_id","manifest_revision",{"_409":442,"_396":5064},{"_409":442,"_396":5063},"arguments",{"_396":5060,"_409":410,"_3586":5061,"_417":5062},{"_409":442,"_396":5059},"From apps_describe. If it changed since, the call is rejected with manifest_changed — re-describe.","Action arguments matching its input_schema. Do not put binary/media bytes here — pass a media_id.",{"_409":442},{},"Action name from apps_describe.","App UUID from apps_search.","higgsfield_apps_describe","Apps describe","Get an app's action contract: with `action`, the full input/output schema + execution mode for that one action; without it, a summary of every action. Also returns `manifest_revision`, which apps_invoke requires. Read-only.",{"_409":410,"_411":5070,"_413":414,"_433":5071},{"_406":3971,"_53":3972},{"_5052":5072,"_3467":5073},[5052],{"_409":442,"_396":5064},{"_396":5074,"_409":442},"Action name. Omit to list all actions in summary.","higgsfield_apps_search","Apps search","Search Higgsfield Marketplace apps callable through MCP. Returns each app's id, name, and the actions it exposes. Flow: apps_search to find an app → apps_describe(app_id, action) to get an action's argument schema + manifest_revision → apps_invoke to run it. Read-only; does not call any app.",{"_409":410,"_411":5080,"_413":414},{"_406":3971,"_53":3972},{"_581":5081,"_1002":5082,"_1000":5083},{"_396":5086,"_409":442},{"_396":5085,"_409":442},{"_396":5084,"_409":492,"_493":30,"_494":516},"Max results (default 20).","Opaque pagination cursor from a previous next_cursor.","Case-insensitive substring over app name/description. Omit to list all.","higgsfield_website_db","Website db","Inspect the website's database (D1 / SQLite), READ-ONLY. The website has ONE database — the live site's real data. Pick an operation: 'tables' (list tables); 'schema' (a table's columns — needs table); 'rows' (a page of rows — needs table; optional filters, order_by + order_dir, limit (default 50) + offset); 'query' (one read-only SELECT/WITH — needs sql). Writes and DDL are rejected.",{"_409":410,"_411":5092,"_413":414,"_433":5093},{"_406":3971,"_53":3972},{"_5094":5096,"_5095":5097,"_468":5098,"_1058":5099,"_5100":5101,"_5102":5103,"_1000":5104,"_4216":5105,"_1454":5106},[5094,5095],"website_id","operation",{"_409":442,"_396":5117},{"_409":442,"_465":5114,"_396":5115},{"_396":5113,"_409":442},{"_396":5111,"_409":596,"_597":5112},"order_by",{"_409":442},"order_dir",{"_409":442,"_465":5108},{"_409":492,"_493":30,"_494":495},{"_409":492,"_493":38,"_494":495},{"_396":5107,"_409":442},"A single read-only SELECT/WITH statement (operation 'query').",[5109,5110],"asc","desc","'rows' filters, each 'col:op[:value]' (eq ne gt gte lt lte like is_null).",{"_409":442},"Table name. Required for 'schema' and 'rows'.",[5116,398,2846,581],"What to read: tables | schema | rows | query.","tables","The website's id (returned by create_website).","higgsfield_website_status","Website status","Get the website's deploy status — the live URL and the status of the last deploy. Use to check a deploy that returned 'pending', or to fetch the live URL.",{"_409":410,"_411":5123,"_413":414,"_433":5124},{"_406":3971,"_53":3972},{"_5094":5125},[5094],{"_409":442,"_396":5117},"higgsfield_participate_in_contest","Participate in contest","Enter the website in the current Higgsfield app contest, together with the social-media links promoting it. A website not yet PUBLISHED to the community feed is published automatically by the entry — no need to call publish_website first. The website DOES need a live production deploy (deploy_website), else the entry is rejected. BEFORE entering, make sure the page metadata in app/src/app-meta.json is filled with real values (og_title etc.) — the auto-publish lists the website on the feed and an empty og_title makes it INVISIBLE there. Pass one or more urls, each a social-media link (YouTube, X/Twitter, Instagram, or TikTok); any other host is rejected. There is a single active contest, so no contest id is needed. Calling again for the same website OVERWRITES its urls (use it to fix or add links), it does not create a second entry.",{"_409":410,"_411":5131,"_413":414,"_433":5132},{"_406":3971,"_53":3972},{"_5094":5134,"_5133":5135},[5094,5133],"urls",{"_409":442,"_396":5117},{"_594":30,"_595":3943,"_409":596,"_597":5136,"_396":5137},{"_409":442},"Social-media links promoting the website (YouTube / X-Twitter / Instagram / TikTok). At least one, at most ten.","higgsfield_publish_website","Publish website","Publish the website: lists the website's CURRENT LIVE production deploy on the Higgsfield community feed ('show in feed'), where other users can discover it. This does NOT deploy — deploy_website (which every build flow already runs) must have shipped the latest changes first; publishing with undeployed changes lists the OLD live build, and re-publishing does not re-deploy. BEFORE publishing, the page metadata in app/src/app-meta.json MUST be filled with real values — og_title, og_description, favicon_url, og_image_url — the feed card renders from them (read fresh from the pushed repo at publish time) and a website with an empty og_title is INVISIBLE on the feed; the live page's own head tags are baked at build time, so deploy AFTER changing them. Also OFFER the user a cover video for the card (og_video_url) — ask their permission first (video generation costs credits), never generate it unprompted. Commit and git push the metadata (and all other changes), then deploy, BEFORE calling this. Publish when the u…",{"_409":410,"_411":5143,"_413":414,"_433":5144},{"_406":3971,"_53":3972},{"_5094":5145},[5094],{"_409":442,"_396":5117},"higgsfield_rename_website","Rename website","Rename the website's SUBDOMAIN (the slug in its public URL). The site is re-deployed under the new subdomain and the OLD subdomain STOPS WORKING — anyone holding the old URL must be given the new one. Storage (database, files, config) and the code repo are KEPT; only the public address changes. Runs a full re-deploy and can take a couple of minutes; returns once the site is live at the new URL. Fails if the new subdomain is already taken or reserved, or if a deploy is already in flight — pick another subdomain and retry.",{"_409":410,"_411":5151,"_413":414,"_433":5152},{"_406":3971,"_53":3972},{"_5094":5154,"_5153":5155},[5094,5153],"new_slug",{"_409":442,"_396":5117},{"_409":442,"_497":30,"_974":4241,"_396":5156},"The new subdomain (the slug in the public URL). Lowercase letters, digits and hyphens; must be globally unique and not a reserved name.","higgsfield_deploy_website","Deploy website","Build and deploy the website via CI, then return its live URL. Every deploy ships the live site at the website's public URL (there is no separate preview stage). IMPORTANT: commit and git push ALL your changes BEFORE calling this — the build runs from the pushed repo. Deploy again after ANY later change: publish_website does NOT deploy (it only lists the already-live build on the community feed), so this tool is the only way changes ship. A failed build returns the log; a still-running build returns status 'pending' — call website_status to check.",{"_409":410,"_411":5162,"_413":414,"_433":5163},{"_406":3971,"_53":3972},{"_5094":5164},[5094],{"_409":442,"_396":5117},"higgsfield_website_secrets","Website secrets","List configured secret names only. Values are never returned. Configure or remove secret values through Higgsfield's website settings; do not ask the user to paste credentials into chat. Secret changes take effect on the next deploy_website.",{"_409":410,"_411":5170,"_413":414,"_433":5171,"_417":418},{"_406":3971,"_53":3972},{"_5094":5172},[5094],{"_409":442,"_497":30},"higgsfield_website_repo_access","Website repo access","Prepare a credential-free checkout in sandbox_exec (operation checkout), or push committed changes (operation push). Use the returned checkout_path to edit and commit with sandbox_exec; then call this tool with push before deploy_website. Each call reserves the user's sandbox for 15 minutes. Checkout reuses existing files; it never resets work. Push rejects uncommitted files and non-fast-forward updates. No Git credentials are returned or installed in the editing sandbox.",{"_409":410,"_411":5178,"_413":414,"_433":5179},{"_406":3971,"_53":3972},{"_5094":5180,"_5095":5181},[5094],{"_409":442,"_497":30},{"_415":5182,"_409":442,"_465":5183},"checkout",[5182,5184],"push","higgsfield_list_website_categories","List website categories","List the content categories a website can be filed under — each with a slug, label, description, and display position. create_website REQUIRES a `category`; call this first to get the valid slugs, then pass the closest one ('other' when nothing fits).",{"_409":410,"_411":5190,"_413":414},{"_406":3971,"_53":3972},{},"higgsfield_list_websites","List websites","List the websites you own — each with its id, name, slug, and live URL. Use this to find the id of a website you created earlier so you can edit, deploy, or check its status.",{"_409":410,"_411":5196,"_413":414},{"_406":3971,"_53":3972},{},"higgsfield_create_website","Create website","Start a new full-stack website. Creates the website and a git repo: a React 19 + TanStack Start app, server-rendered, in ONE Cloudflare Worker, with D1 / R2 / KV / Durable Objects / Containers available (all DISABLED by default). Returns a website_id — pass it to every later website tool. The 'type' param is REQUIRED and is the USER'S choice, not yours: unless the user has already made it unambiguous, ASK the user whether they want a plain website (no Higgsfield integration) or a Higgsfield-integrated app (Sign in with Higgsfield + AI image/video generation via the Higgsfield SDK) BEFORE calling this tool. Apps are scaffolded from a v2 starter template and REQUIRE the 'template' param — pick the closest of studio / preset / app-detail per the template param's guide ('custom' is ONLY for when the user explicitly says \"use custom template\" — never pick it yourself). The chosen layout ships as real code already wired as the home page; you ADAPT IT IN PLACE, never rebuild it. Websites take an OPTIONAL template: …",{"_409":410,"_411":5202,"_413":414,"_433":5203},{"_406":3971,"_53":3972},{"_409":5204,"_4038":5205,"_5206":5207,"_5208":5209},[409,4038],{"_409":442,"_465":5218,"_396":5219},{"_409":442,"_396":5217},"template",{"_396":5211,"_409":442,"_465":5212},"subdomain",{"_396":5210,"_409":442},"The website's subdomain — it becomes the slug, so the live URL is .. ALWAYS set this: pick a short, memorable subdomain from the site's name or purpose (lowercase letters, digits, and single hyphens only; DNS-safe). Only omit it — which falls back to a random subdomain — if the user explicitly asks for a random one. A few reserved labels (e.g. 'api', 'www') and already-taken subdomains are rejected; if that happens, try a close variant.","The starter template the repo is scaffolded from. Its code arrives already wired as the home page — you adapt it in place, not rebuild it. The valid names depend on `type`, and a mismatch is rejected. type='website' — OPTIONAL: 'scroll-scrub' = the animated website (the visitor's scroll plays a generated film); its scrub engine ships pre-built, so you generate the film and fill in scenes instead of writing a controller. Pass it for EVERY animated website (the default per the website-builder flow). OMIT `template` only for a non-animated site. Never pass an app template for a website. type='app' — REQUIRED, pick the closest to the product: 'studio' = full creative workspace (projects sidebar + floating prompt dock + edge-to-edge generations feed) for multi-project generation tools; 'preset' = pick-a-style-then-generate (persistent left creation rail beside a browsable preset grid with History tab); 'app-detail' = a single tool's landing page (two-column generator hero + how-it-works steps) — the 'simple app'. Any other request shape (before/after slider, step-by-step wizard, upload-configure-iterate) still maps to the closest of these three; the shared components in app/src/components/ cover those patterns. 'custom' (bare shell, no shipped layout) is ONLY for when the user explicitly says \"use custom template\" — never pick it yourself. ",[5213,5214,5215,1175,5216],"app-detail","preset","studio","scroll-scrub","REQUIRED — the content category the website is filed under, a slug from the marketplace taxonomy (e.g. 'cinematic', 'ads-marketing', 'ugc-social', 'other'). Call list_website_categories to get the exact valid slugs, then pass the closest one ('other' when nothing fits). The server rejects an unknown slug.",[5220,88,5221],"REQUIRED — what the user chose to build. 'website': a standalone site with NO Higgsfield integration (no Sign in with Higgsfield, no requests to Higgsfield). 'app': a product tightly integrated with Higgsfield — its users sign in with Higgsfield and generate images/videos through the Higgsfield SDK. 'game': a browser game with realtime multiplayer rooms — requires a game genre as category and takes NO template. This is the user's decision: if their request doesn't make it obvious, ask them which one they want before creating.","website","game","higgsfield_get_workflow_bundle_file","Get workflow bundle file","Read a safe text file or directory from a workflow's resource folder. Use this after get_workflow_instructions when the SKILL.md requires a template, reference, or script file.",{"_409":410,"_411":5227,"_413":414,"_433":5228},{"_406":3971,"_53":3972},{"_5229":5230,"_100":5231,"_5232":5233},[5229,100],"workflow",{"_409":442,"_497":30,"_396":5236},{"_409":442,"_497":30,"_396":5235},"include_contents",{"_396":5234,"_409":1097},"For directory paths, include the content of every allowed file under that directory. Defaults to false.","Whitelisted path INSIDE that workflow folder, e.g. 'references/app-flow.md' for website-builder-flow. Use paths listed by get_workflow_instructions.","Workflow name whose folder holds the file, e.g. 'website-builder-flow'.","higgsfield_get_workflow_instructions","Get workflow instructions","For an explicit named preset slash command, resolve get_preset_instructions first and follow its recipe instead of selecting a workflow by name similarity. Consult 'test-edit' for supplemental editing-engine context and optional sandbox helpers when useful to the current task or preset. It does not start an edit, require footage/music, prescribe a genre, or replace the active workflow; /test-edit alone loads context. Ordinary montage/captions and native editable projects retain their existing workflows. Ad Multiplier — load workflow 'ad-multiplier' when the user asks to 'multiply my video', 'multiply my ad', create multiple independently edited versions of one supplied 4-30 second video, regenerate the same ad with different people or products, or recreate one supplied ad as new footage for another market, audience, spoken language, cast, or product. Load this workflow before Marketing Studio, model browsing, or direct generation. For finished-file cuts, clip assembly, soundtrack changes or burned speech cap…",{"_409":410,"_411":5242,"_413":414},{"_406":3971,"_53":3972},{"_5229":5243},{"_396":5244,"_409":442,"_497":30},"Workflow name (a folder under the workflows resource root, e.g. 'website-builder-flow'). Omit to list all available workflows.","higgsfield_sync_agents","Sync agents","Sync Agents — imports the user's user-authored Skills and a personality dump from the current host LLM into Higgsfield. One trigger, one upload, one final confirmation. Calling modes: 1. `message: \"/sync-agents\"` — server returns a short ack in `content[0].text` plus an assistant-only directive containing a self-contained Python upload script (pre-wired with a one-time presigned POST URL scoped to one per-user prefix). Print the ack verbatim. Then follow the directive: enumerate user-authored skills + synthesize `personality.md` into `/tmp/profile-import/{skills,personality}/`, run the script in your code-execution sandbox, capture its single-line JSON summary, and call this tool again with that summary as `message`. 2. `message: \"