Docs
REST API
MCP Tools API
Information
analytics
Fetch post performance analytics
post
Refresh analytics data from connected platforms
post
apps
Open a project-scoped interactive calendar inside MCP App-capable hosts. Uses reschedule_post for conflict-safe drag/drop and schedule_post for new posts.
post
Open a project-scoped interactive performance dashboard with views, engagement, platform mix, and top posts.
post
autopilot
List autopilot configurations
post
Update autopilot configuration
post
Get current autopilot status
post
Create a new autopilot configuration
post
brand
Extract brand identity from URL or text
post
Get the current brand profile
post
Save or update brand profile
post
Update platform-specific brand voice settings
post
brandRuntime
Get the full 4-layer brand runtime (messaging, voice, visual, constraints)
post
Explain brand completeness, confidence, and recommendations
post
Check content text for brand voice/vocabulary/claim consistency
post
Audit brand color palette for accessibility, contrast, and harmony
post
Export brand design tokens in CSS/Tailwind/JSON formats
post
carousel
End-to-end carousel: generate text + kick off image jobs for each slide
post
comments
List YouTube comments on published videos (YouTube only today)
post
Reply to a YouTube comment (YouTube only today)
post
Post a new YouTube comment (YouTube only today)
post
Moderate a YouTube comment (approve/hide/flag) (YouTube only today)
post
Delete a YouTube comment (YouTube only today)
post
content
Adapt existing content for different platforms
post
Generate video content using AI
post
Generate images using AI
post
Check status of async content generation job
post
Create a video storyboard with scenes and shots
post
Generate AI voiceover audio
post
Generate carousel/slide content
post
credits
Get current credit balance
post
Get budget and spending status
post
digest
Generate a performance summary with trends and recommendations
post
Detect significant performance changes (spikes, drops, viral)
post
discovery
Search and discover available MCP tools
post
Search public Social Neuron product, integration, developer, and MCP tool knowledge using the ChatGPT-compatible search schema.
post
Fetch one public Social Neuron knowledge document by ID using the ChatGPT-compatible fetch schema.
post
distribution
Schedule content for publishing to social platforms
post
Atomically move an unclaimed scheduled post to a new time within its brand project
post
List recently published or scheduled posts
post
List connected social media accounts
post
Mint a single-use deep link for a user to complete platform OAuth in their browser
post
Poll until a platform connection becomes active or timeout
post
extraction
Extract content from a URL for repurposing
post
hyperframes
List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions
post
Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step
post
ideation
Generate social media content ideas based on brand profile and trends
post
Fetch current trending topics for content ideation
post
ideation-context
Get full ideation context including brand, analytics, and trends
post
insights
Get AI-generated performance insights
post
Get recommended posting times based on audience data
post
lifecycle
Cancel an owned pending async job and refund an eligible debit
post
Delete an owned carousel content record from one project
post
Cancel an owned scheduled post before publishing begins
post
Permanently delete an owned content plan from one project
post
Permanently delete an owned autopilot configuration from one project
post
loop-summary
Get growth loop summary and recommendations
post
media
Upload local file or external URL to R2 storage
post
Sign an R2 key to get a fresh download URL
post
pipeline
Pre-flight check before running a content pipeline
post
End-to-end content pipeline: plan → quality → approve → schedule
post
Check status of a pipeline run
post
Batch auto-approve posts meeting quality thresholds
post
plan-approvals
Create approval requests for a content plan
post
Respond to a plan approval request
post
List pending plan approval requests
post
planning
Generate a weekly content plan
post
Save a content plan
post
Get a specific content plan by ID
post
Update an existing content plan
post
Submit a content plan for team approval
post
Schedule all posts in an approved content plan
post
Find next available scheduling slots
post
quality
Run quality checks on content before publishing
post
Run quality checks on an entire content plan
post
Pre-render visual QA on carousel slides — predicts text overflow against per-layout constraints. Run before schedule_post to catch clipped text.
post
Read the per-layout field constraints (font size, width, max lines) the visual gate uses. Useful when generating slide text that fits first time.
post
recipes
List available recipe templates for automated content workflows
post
Get full details of a recipe template including steps and required inputs
post
Execute a recipe template with provided inputs to run a multi-step workflow
post
Check the status and progress of a running recipe execution
post
remotion
Render a demo video using Remotion
post
List available Remotion video compositions
post
Render a template video in the cloud via async job
post
research
Find QA-gated high-performing short-form videos in the project's niche. Returns extracted hook patterns, content structures, and pre-compiled replication prompts.
post
skills
List Social Neuron content workflow skills available to the user. A skill is a brand-locked multi-step pipeline inspired by documented viral patterns (MrBeast 3-second hook, Hormozi pattern interrupt, etc.).
post
Fetch the full body of a single Social Neuron skill by slug — hand-maintained strategy/specs plus the machine-maintained "what's working now" compiled section. Use after list_skills for the actual platform playbook.
post
Preview only: returns a structured run preview, estimated credits, and a dashboard deep link — it does not execute the skill. Run a Social Neuron workflow skill end-to-end (brand-locked content production). Returns a structured run preview with the step plan, credit cost, and a deep-link to launch in the SN dashboard.
post
suggest
Suggest next content topics based on performance data
post
usage
Get MCP usage statistics for the current billing period
post
youtube-analytics
Fetch YouTube channel analytics data
post
Schemas
Menu
Social Neuron REST API
Social Neuron REST API
Schemas
ToolResult
MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.
content
object[]
structuredContent
object
isError
boolean
ToolError
error
object
·
required
