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

Short description — what the tool does AND when the model should call it.post

Get post performance metrics — views, likes, comments, shares, and engagement rate.post

Queue analytics refresh jobs for all posts from the last 7 days across connected platforms.post

List autopilot configurations showing schedules, credit budgets, last run times, and active/inactive status.post

Update an existing autopilot configuration.post

Get autopilot system overview: active config count, recent execution results, credits consumed, and next scheduled run time.post

Create a new autopilot configuration for automated content pipeline execution.post

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo.post

Load the active persisted brand profile for a project from brand_profiles.post

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc.post

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy).post

Get the full brand runtime for a project.post

Explains what brand data is available vs missing for a project.post

Check if content text is consistent with the brand voice, vocabulary, messaging, and factual claims.post

Audit content colors against the brand palette using perceptual color distance (Delta E 2000).post

Export brand palette and typography as design tokens.post

End-to-end carousel creation: generates slide text + kicks off image generation for each slide in parallel.post

List YouTube comments — pass video_id (11-char string, e.post

Reply to a YouTube comment.post

Post a new top-level comment on a YouTube video, authored as the connected channel.post

Moderate a YouTube comment on your channel — set status to published (approve) or rejected (hide from public view but kept in moderation queue).post

Delete a YouTube comment.post

Begin connecting a social platform (Instagram, TikTok, YouTube, etc.post

Poll until a platform connection becomes active.post

Start an async AI video generation job — returns a job_id immediately.post

Start an async AI image generation job — returns a job_id immediately.post

Poll an async job started by generate_video or generate_image.post

Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame.post

Generate a voiceover audio file for video narration.post

Generate carousel slide content (headlines, body text, emphasis words per slide).post

Check remaining credits, monthly limit, spending cap, and plan tier.post

Check how much of the per-session budget has been consumed.post

Generate a performance summary for a time period.post

Detect significant performance changes: spikes, drops, viral content, trend shifts.post

Search available tools by name, description, module, or scope.post

Publish or schedule a post to connected social platforms.post

Check which social platforms have active OAuth connections for posting.post

List recent published and scheduled posts with status, platform, title, and timestamps.post

Find optimal posting time slots based on best posting times and existing schedule.post

Schedule all posts in a content plan.post

Extract text content from any URL — YouTube video transcripts, article text, or product page features/benefits/USP.post

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) the agent can compose into an HTML video composition.post

Render an HTML video composition (Hyperframes) to MP4.post

Ideation Context

Get synthesized ideation context from performance insights.post

Create a script, caption, hook, or blog post tailored to a specific platform.post

Get current trending topics for content inspiration.post

Rewrite existing content for a different platform — adjusts character limits, hashtag style, tone, and CTA format automatically.post

Query performance insights derived from post analytics.post

Analyze post analytics data to find the best times to post for maximum engagement.post

Get a one-call dashboard summary of the feedback loop state (brand profile, recent content, and current insights).post

Upload media to persistent R2 storage.post

Get a fresh signed URL for an R2 media key.post

Find QA-gated high-performing short-form videos in the projects niche.post

Pre-flight check before run_content_pipeline.post

Run the full content pipeline: research trends → generate plan → quality check → auto-approve → schedule posts.post

Check status of a pipeline run, including stages completed, pending approvals, and scheduled posts.post

Batch auto-approve posts in a content plan that meet quality thresholds.post

Create pending approval rows for each post in a content plan — one row per post, status=pending.post

List approval items for a content plan, optionally filtered by status (pending / approved / rejected / edited).post

Approve, reject, or edit a single pending plan approval item.post

Generate a full content plan with platform-specific drafts, hooks, angles, and optimal schedule times.post

Save a content plan to the database for team review, approval workflows, and scheduled publishing.post

Load a persisted content plan by its UUID — returns the full plan including all posts, scheduling status, and approval state.post

Edit individual posts in a persisted content plan — change caption, title, hashtags, hook, or angle.post

Create pending approval items for each post in a plan and mark plan status as in_review.post

Score post quality across 7 categories: Hook Strength, Message Clarity, Platform Fit, Brand Alignment, Novelty, CTA Strength, and Safety/Claims.post

Batch quality check all posts in a content plan.post

List available recipe templates.post

Get full details of a recipe template including all steps, input schema, and estimated costs.post

Execute a recipe template with the provided inputs.post

Check the status of a running recipe execution.post

List all available Remotion video compositions defined in Social Neuron.post

Render a Remotion composition to an MP4 or GIF file locally.post

Render a Remotion template video in the cloud.post

Navigate to a Social Neuron app page and take a full-page screenshot.post

Take a screenshot of any URL.post

Suggest next content topics based on performance insights, past content, and competitor patterns.post

Get your MCP API usage breakdown for the current billing month.post

Run a pre-render visual QA check on carousel slides before publishing.post

Read the per-layout field constraints used by the visual QA gate (font size, effective width, max lines per field).post

YouTube Analytics

Fetch YouTube channel analytics.post

Social Neuron MCP Tools API

Social Neuron MCP Tools API

Universal tool proxy for 81 Social Neuron MCP tools. Each tool is accessible via POST /v1/tools/{tool_name} with JSON parameters. Authenticate with an API key (prefix snk_) in the x-api-key header. Credits are consumed per operation — check balance with get_credit_balance.

Tags

_template tools (scope: mcp:read, credits: ~0)

Analytics tools (scope: mcp:analytics, credits: ~0)

Autopilot tools (scope: mcp:autopilot, credits: ~0)

Brand tools (scope: mcp:read/write, credits: ~0-3)

brandRuntime tools (scope: mcp:read, credits: ~0)

carousel tools (scope: mcp:read, credits: ~0)

Comments tools (scope: mcp:comments, credits: ~0-1)

connections tools (scope: mcp:read, credits: ~0)

Content tools (scope: mcp:write, credits: ~5-50)

Credits tools (scope: mcp:read, credits: ~0)

digest tools (scope: mcp:read, credits: ~0)

discovery tools (scope: mcp:read, credits: ~0)

Distribution tools (scope: mcp:distribute, credits: ~1-3)

Extraction tools (scope: mcp:read, credits: ~0-1)

hyperframes tools (scope: mcp:read, credits: ~0)

Ideation Context

Ideation Context tools (scope: mcp:read, credits: ~0)

Ideation tools (scope: mcp:write, credits: ~1-5)

Insights tools (scope: mcp:analytics, credits: ~0)

Loop Summary tools (scope: mcp:read, credits: ~0)

media tools (scope: mcp:read, credits: ~0)

niche-research tools (scope: mcp:read, credits: ~0)

pipeline tools (scope: mcp:read, credits: ~0)

Plan Approvals tools (scope: mcp:write, credits: ~0)

Planning tools (scope: mcp:write, credits: ~1-3)

Quality tools (scope: mcp:read, credits: ~0-1)

recipes tools (scope: mcp:read, credits: ~0)

Remotion tools (scope: mcp:write, credits: ~5-20)

Screenshots tools (scope: mcp:read, credits: ~1)

suggest tools (scope: mcp:read, credits: ~0)

Usage tools (scope: mcp:read, credits: ~0)

visualQuality tools (scope: mcp:read, credits: ~0)

YouTube Analytics

YouTube Analytics tools (scope: mcp:analytics, credits: ~0)

ContactSocial Neuronsupport@socialneuron.com https://socialneuron.com

Servers

https://api.socialneuron.com

Production