Docs
REST API
MCP Tools API

Product

Dashboard
Pricing
What's New

Developers

REST API
MCP Tools API
CLI Reference
npm Package
GitHub

Support

Help & Support
FAQ
Email Support

Community

X / Twitter
GitHub
Privacy Policy
Terms of Service

Fetch post performance analyticspost

Refresh analytics data from connected platformspost

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

List autopilot configurationspost

Update autopilot configurationpost

Get current autopilot statuspost

Create a new autopilot configurationpost

Extract brand identity from URL or textpost

Get the current brand profilepost

Save or update brand profilepost

Update platform-specific brand voice settingspost

Get the full 4-layer brand runtime (messaging, voice, visual, constraints)post

Explain brand completeness, confidence, and recommendationspost

Check content text for brand voice/vocabulary/claim consistencypost

Audit brand color palette for accessibility, contrast, and harmonypost

Export brand design tokens in CSS/Tailwind/JSON formatspost

End-to-end carousel: generate text + kick off image jobs for each slidepost

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

Adapt existing content for different platformspost

Generate video content using AIpost

Generate images using AIpost

Check status of async content generation jobpost

Create a video storyboard with scenes and shotspost

Generate AI voiceover audiopost

Generate carousel/slide contentpost

Get current credit balancepost

Get budget and spending statuspost

Generate a performance summary with trends and recommendationspost

Detect significant performance changes (spikes, drops, viral)post

Search and discover available MCP toolspost

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

Schedule content for publishing to social platformspost

Atomically move an unclaimed scheduled post to a new time within its brand projectpost

List recently published or scheduled postspost

List connected social media accountspost

Mint a single-use deep link for a user to complete platform OAuth in their browserpost

Poll until a platform connection becomes active or timeoutpost

Extract content from a URL for repurposingpost

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositionspost

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 steppost

Generate social media content ideas based on brand profile and trendspost

Fetch current trending topics for content ideationpost

ideation-context

Get full ideation context including brand, analytics, and trendspost

Get AI-generated performance insightspost

Get recommended posting times based on audience datapost

Cancel an owned pending async job and refund an eligible debitpost

Delete an owned carousel content record from one projectpost

Cancel an owned scheduled post before publishing beginspost

Permanently delete an owned content plan from one projectpost

Permanently delete an owned autopilot configuration from one projectpost

Get growth loop summary and recommendationspost

Upload local file or external URL to R2 storagepost

Sign an R2 key to get a fresh download URLpost

Pre-flight check before running a content pipelinepost

End-to-end content pipeline: plan → quality → approve → schedulepost

Check status of a pipeline runpost

Batch auto-approve posts meeting quality thresholdspost

Create approval requests for a content planpost

Respond to a plan approval requestpost

List pending plan approval requestspost

Generate a weekly content planpost

Save a content planpost

Get a specific content plan by IDpost

Update an existing content planpost

Submit a content plan for team approvalpost

Schedule all posts in an approved content planpost

Find next available scheduling slotspost

Run quality checks on content before publishingpost

Run quality checks on an entire content planpost

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

List available recipe templates for automated content workflowspost

Get full details of a recipe template including steps and required inputspost

Execute a recipe template with provided inputs to run a multi-step workflowpost

Check the status and progress of a running recipe executionpost

Render a demo video using Remotionpost

List available Remotion video compositionspost

Render a template video in the cloud via async jobpost

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

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 next content topics based on performance datapost

Get MCP usage statistics for the current billing periodpost

youtube-analytics

Fetch YouTube channel analytics datapost

Social Neuron REST API

Social Neuron REST API

usage

Get MCP usage statistics for the current billing period

POST

https://mcp.socialneuron.com/v1

/tools/get_mcp_usage

Get MCP usage statistics for the current billing period › Request Body

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Get MCP usage statistics for the current billing period › Responses

Tool executed. isError:true in the body indicates a tool-level error.

MCP CallToolResult. `content` carries text/structured blocks; `structuredContent` is present when the tool declares structured output.

object[]

object

isError

boolean

POST/tools/get_mcp_usage

curl https://mcp.socialneuron.com/v1/tools/get_mcp_usage \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "response_format": "text"
}'

Example Request Body

{
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "type",
      "text": "text"
    }
  ],
  "structuredContent": {},
  "isError": true
}

json

application/json

suggest youtube-analytics