io.github.conquext/neuron

Fetch any image/video/audio URL and re-host it on Neuron so it's stable and server-reachable — use this on external/temporary URLs (AI-generated b-roll, etc.) before placing them with add_image/add_video/add_audio. Returns { url, filename }.

Submit a Studio ProjectDoc for a headless MP4 render. Returns a job id — poll neuron_studio_render_status until 'completed'. Any media (video/image) in the doc must be a server-reachable URL (use neuron_studio_import_media_url / neuron_studio_upload_media first). Requires a Pro+ plan.

Poll a render job by id. When status is 'completed', outputUrl is the finished MP4. status is queued | rendering | completed | failed.

Persist a ProjectDoc and get back an `openUrl`. Opening it drops the video into the Studio in the user's browser, where 'Export MP4' renders CLIENT-SIDE (on their machine, no server render cost). Use this for the hybrid flow: build with neuron_studio_apply/agent, then save and hand the user the link. Use neuron_studio_render instead only for headless/unattended server renders.

Transcribe a hosted media/audio URL into time-coded caption cues { cues:[{startSeconds,endSeconds,text}] }. Feed them to neuron_studio_apply add_captions to subtitle existing footage. Needs a transcription key on the org.

Run an AI transform on a hosted video via Replicate (async): op 'bg-remove' or 'face-swap' (face-swap needs imageUrl). Returns { id, status } — poll neuron_studio_transform_video_status for videoUrl. Needs the matching model version configured.

Poll a video-transform job. When status is 'succeeded', videoUrl is the result (external — re-host before use).

Upload a local image/video (base64) to the Studio media store (uncapped) so the renderer can fetch it. Returns { url, filename }. Put the url on an image/video layer.

Turn a script into a hosted voiceover audio URL, optionally with caption cues synced to the speech. Returns { url, durationSeconds, cues? }. Then place it with neuron_studio_apply: add_audio({url, label:'Voiceover', durationSeconds}) and add_captions({cues}). This makes fully-voiced reels possible from a prompt. Needs a TTS key on the org (captions also need a transcription key).

Submit a draft ad request for admin review. The request must be in draft status. After submission, an admin must approve it before it can be funded.

Submit a draft campaign for admin review and approval. The campaign must be in 'draft' status.

Submit a contact list to the shared pool marketplace for other organizations to discover and use for ad distribution.

Switch the MCP server to target a different Neuron backend instance. Auth tokens are preserved per instance — if you've previously logged in to an instance, switching back restores your session automatically. Call with no args to list known instances and see which is active.

Switch to a different organization. Returns a new access token scoped to the target organization and automatically sets it.

Trigger a synchronization operation to refresh embeddings, reindex content, or update the knowledge base state.

Synchronize and import WhatsApp Channels from a connected WhatsApp session into Neuron. Discovers channels created outside Neuron.

Synchronize all approved reflections into the bot's active knowledge base, applying learned insights to future conversations.

Synchronize contacts from all connected WhatsApp channels into the organization's contact database. Creates new contacts for unseen numbers.

Transfer control of a conversation from the bot to a human agent. The bot will stop auto-responding until the conversation is released.

Find available slots across all team calendars. Mode 'any' returns slots where at least one member is free (round-robin), 'all' requires everyone to be free (collective).

Execute a dry-run test of a custom API tool with sample arguments to verify the endpoint responds correctly.

Toggle a built-in tool on or off for a specific bot. Enabled tools become available in the bot's conversations. Example tool IDs: delete_message, post_to_channel, post_status, web_search, send_direct_message, react_to_message, set_reminder, create_poll.

Toggle the featured status of a pool item. Featured items appear prominently in the marketplace. Requires admin privileges.

Enable or disable a flow. Disabled flows stop receiving events but retain their graph.

Pause or resume a scheduled task (flips its enabled state and reschedules the next run).

Remove the bot assignment from a WhatsApp channel. The channel will stop auto-responding to messages.

Remove the bot assignment from a social media channel. The bot will lose access to the channel's social media credentials.

Unblock a previously blocked WhatsApp contact.

Permanently remove a published item from the marketplace pool. Organizations that installed this item will retain their copies.

Update a draft or rejected ad request. Only draft and rejected ad requests can be edited. Rejected requests revert to draft on update.

Set the weekly availability hours for a calendar. Each day maps to an array of { start, end } time windows in HH:mm format.

Update an existing blog post's content, metadata, status, or SEO fields. Only provided fields are changed.

Add or update host notes on a booking.

Update an existing bot's configuration. Only provided fields are modified; omitted fields remain unchanged.

Update an existing broadcast's name, message content, or media before sending. The broadcast must still be in draft status.

Update a calendar's settings. Only provided fields are modified.

Update a campaign that is in 'draft' or 'rejected' status. Active or completed campaigns cannot be modified.

Update configuration of an existing WhatsApp channel. Only provided fields are modified; omitted fields remain unchanged.

Update an existing contact's details. If notes are provided, they are appended as a new structured note entry without overwriting existing notes.

Update an existing contact list's name, slug, description, criteria, or refresh schedule.

Update a host-created event. Use scope='future' to update all future instances of a recurring series.

Update an event type's settings. Only provided fields are modified.

Update a flow's name, description, graph, or enabled state. Only provided fields are changed. When updating the graph, provide the COMPLETE graph (all nodes and edges) — it replaces the existing graph entirely. When a graph is supplied the response includes a non-blocking `warnings` array (same checks as create_flow) — check it and fix any flagged issues.

Update the description of a WhatsApp group. Requires the bot to be a group admin.

Add, remove, promote, or demote members in a WhatsApp group. Provide phone numbers or JIDs. Requires admin privileges.

Change WhatsApp group settings: 'announcement' (only admins send), 'not_announcement' (everyone sends), 'locked' (only admins edit info), 'unlocked' (everyone edits info). Requires admin.

Update the name/subject of a WhatsApp group. Requires the bot to be a group admin.

Update the content, title, folder, or source of an existing knowledge base entry.

Update the properties of an existing knowledge base such as name, description, or root instruction.

Update a paced list campaign's name, message source, batch size, schedule, exhaust behavior, or send settings. Changing the schedule reschedules the next run.