Social Neuron MCP Tools API

pipeline

Endpoint:https://api.socialneuron.com

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

Pre-flight check before run_content_pipeline.

POST

https://api.socialneuron.com

/v1/tools/check_pipeline_readiness

Pre-flight check before run_content_pipeline. Verifies: sufficient credits for estimated_posts, active OAuth on target platforms, brand profile exists, no stale insights. Returns pass/fail with specific issues to fix before running the pipeline.

Pre-flight check before run_content_pipeline. › Request Body

platformsstring[] · required
Target platforms to check
estimated_postsnumber · required
Estimated posts to generate

project_idstring · uuid
Project ID (auto-detected if omitted)
response_formatstring · enum
Response format
Enum values:
text
json

Pre-flight check before run_content_pipeline. › Responses

contentobject[]

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

POST

https://api.socialneuron.com

/v1/tools/run_content_pipeline

Run the full content pipeline: research trends → generate plan → quality check → auto-approve → schedule posts. Chains all stages in one call for maximum efficiency. Set dry_run=true to preview the plan without publishing. Check check_pipeline_readiness first to verify credits, OAuth, and brand profile are ready.

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

platformsstring[] · required
Target platforms
daysnumber · required
Days to plan
posts_per_daynumber · required
Posts per platform per day
approval_modestring · enum · required
auto: approve all passing quality. review_all: flag everything. review_low_confidence: auto-approve high scorers.
Enum values:
auto
review_all
review_low_confidence
auto_approve_thresholdnumber · required
Quality score threshold for auto-approval (used in auto/review_low_confidence modes)
dry_runboolean · required
If true, skip scheduling and return plan only
response_formatstring · enum · required
Enum values:
text
json

project_idstring · uuid
Project ID (auto-detected if omitted)
topicstring
Content topic (required if no source_url)
source_urlstring
URL to extract content from
max_creditsnumber
Credit budget cap
skip_stagesstring · enum
Stages to skip
Enum values:
research
quality
schedule

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

contentobject[]

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

POST

https://api.socialneuron.com

/v1/tools/get_pipeline_status

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

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

pipeline_idstring · uuid
Pipeline run ID (omit for latest)
response_formatstring · enum
Enum values:
text
json

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

contentobject[]

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

POST

https://api.socialneuron.com

/v1/tools/auto_approve_plan

Batch auto-approve posts in a content plan that meet quality thresholds. Posts below the threshold are flagged for manual review.

Batch auto-approve posts in a content plan that meet quality thresholds. › Request Body

plan_idstring · uuid · required
Content plan ID
quality_thresholdnumber · required
Minimum quality score to auto-approve
response_formatstring · enum · required
Enum values:
text
json

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

contentobject[]

Loop Summary Plan Approvals

Social Neuron MCP Tools API

pipeline

Endpoint:https://api.socialneuron.com

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

Pre-flight check before run_content_pipeline.

POST

https://api.socialneuron.com

/v1/tools/check_pipeline_readiness

Pre-flight check before run_content_pipeline. › Request Body

platformsstring[] · required
Target platforms to check
estimated_postsnumber · required
Estimated posts to generate

project_idstring · uuid
Project ID (auto-detected if omitted)
response_formatstring · enum
Response format
Enum values:
text
json

Pre-flight check before run_content_pipeline. › Responses

contentobject[]

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

POST

https://api.socialneuron.com

/v1/tools/run_content_pipeline

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

platformsstring[] · required
Target platforms
daysnumber · required
Days to plan
posts_per_daynumber · required
Posts per platform per day
approval_modestring · enum · required
auto: approve all passing quality. review_all: flag everything. review_low_confidence: auto-approve high scorers.
Enum values:
auto
review_all
review_low_confidence
auto_approve_thresholdnumber · required
Quality score threshold for auto-approval (used in auto/review_low_confidence modes)
dry_runboolean · required
If true, skip scheduling and return plan only
response_formatstring · enum · required
Enum values:
text
json

project_idstring · uuid
Project ID (auto-detected if omitted)
topicstring
Content topic (required if no source_url)
source_urlstring
URL to extract content from
max_creditsnumber
Credit budget cap
skip_stagesstring · enum
Stages to skip
Enum values:
research
quality
schedule

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

contentobject[]

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

POST

https://api.socialneuron.com

/v1/tools/get_pipeline_status

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

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

pipeline_idstring · uuid
Pipeline run ID (omit for latest)
response_formatstring · enum
Enum values:
text
json

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

contentobject[]

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

POST

https://api.socialneuron.com

/v1/tools/auto_approve_plan

Batch auto-approve posts in a content plan that meet quality thresholds. Posts below the threshold are flagged for manual review.

Batch auto-approve posts in a content plan that meet quality thresholds. › Request Body

plan_idstring · uuid · required
Content plan ID
quality_thresholdnumber · required
Minimum quality score to auto-approve
response_formatstring · enum · required
Enum values:
text
json

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

contentobject[]

Loop Summary Plan Approvals

​pipeline

​Pre-flight check before run_content_pipeline.

​Pre-flight check before run_content_pipeline. › Request Body

​Pre-flight check before run_content_pipeline. › Responses

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

​Run the full content pipeline: research trends → generate plan → quality check → auto-approve → schedule posts. › Request Body

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

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

​Check status of a pipeline run, including stages completed, pending approvals, and scheduled posts. › Request Body

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

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

​Batch auto-approve posts in a content plan that meet quality thresholds. › Request Body

​Batch auto-approve posts in a content plan that meet quality thresholds. › Responses

​pipeline

​Pre-flight check before run_content_pipeline.

​Pre-flight check before run_content_pipeline. › Request Body

​Pre-flight check before run_content_pipeline. › Responses

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

​Run the full content pipeline: research trends → generate plan → quality check → auto-approve → schedule posts. › Request Body

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

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

​Check status of a pipeline run, including stages completed, pending approvals, and scheduled posts. › Request Body

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

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

​Batch auto-approve posts in a content plan that meet quality thresholds. › Request Body

​Batch auto-approve posts in a content plan that meet quality thresholds. › Responses

pipeline

Pre-flight check before run_content_pipeline.

Pre-flight check before run_content_pipeline. › Request Body

Pre-flight check before run_content_pipeline. › Responses

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

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

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

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

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

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

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

Batch auto-approve posts in a content plan that meet quality thresholds. › Request Body

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

pipeline

Pre-flight check before run_content_pipeline.

Pre-flight check before run_content_pipeline. › Request Body

Pre-flight check before run_content_pipeline. › Responses

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

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

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

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

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

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

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

Batch auto-approve posts in a content plan that meet quality thresholds. › Request Body

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