pipeline

Pre-flight check before running a content pipeline

POST

https://mcp.socialneuron.com/v1

/tools/check_pipeline_readiness

Pre-flight check before running a content pipeline › Request Body

platforms

string[] · minItems: 1 · required

Target platforms to check

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Project ID (auto-detected if omitted)

estimated_posts

number · min: 1 · max: 50

Estimated posts to generate

Default: 5

response_format

string · enum

Response format

Enum values:

text

json

Pre-flight check before running a content pipeline › 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.

ToolResult

object[]

object

isError

boolean

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

POST

https://mcp.socialneuron.com/v1

/tools/run_content_pipeline

End-to-end content pipeline: plan → quality → approve → schedule › Request Body

platforms

string[] · minItems: 1 · required

Target platforms

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Project ID (auto-detected if omitted)

topic

string

Content topic (required if no source_url)

source_url

string

URL to extract content from

object

Exact connected-account ID per target platform. Required when a project has multiple accounts on one platform.

days

number · min: 1 · max: 7

Days to plan

Default: 5

posts_per_day

number · min: 1 · max: 3

Posts per platform per day

Default: 1

approval_mode

string · enum

auto: approve all passing quality. review_all: flag everything. review_low_confidence: auto-approve high scorers.

Enum values:

auto

review_all

review_low_confidence

Default: review_low_confidence

auto_approve_threshold

number · min: 0 · max: 35

Quality score threshold for auto-approval (used in auto/review_low_confidence modes)

Default: 28

max_credits

number

Credit budget cap

dry_run

boolean

If true, skip scheduling and return plan only

Default: false

schedule_confirmed

boolean

Required to schedule posts. Set true only after explicit user confirmation to publish/schedule.

Default: false

skip_stages

string[]

Stages to skip

Enum values:

research

quality

schedule

response_format

string · enum

Enum values:

text

json

Default: json

End-to-end content pipeline: plan → quality → approve → schedule › 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.

ToolResult

object[]

object

isError

boolean

POST/tools/run_content_pipeline

curl https://mcp.socialneuron.com/v1/tools/run_content_pipeline \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "topic": "topic",
  "source_url": "source_url",
  "platforms": [
    "youtube"
  ],
  "account_ids": {
    "key": "00000000-0000-0000-0000-000000000000"
  },
  "days": 5,
  "posts_per_day": 1,
  "approval_mode": "review_low_confidence",
  "auto_approve_threshold": 28,
  "max_credits": 0,
  "dry_run": false,
  "schedule_confirmed": false,
  "skip_stages": [
    "research"
  ],
  "response_format": "json"
}'

Example Request Body

{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "topic": "topic",
  "source_url": "source_url",
  "platforms": [
    "youtube"
  ],
  "account_ids": {
    "key": "00000000-0000-0000-0000-000000000000"
  },
  "days": 5,
  "posts_per_day": 1,
  "approval_mode": "review_low_confidence",
  "auto_approve_threshold": 28,
  "max_credits": 0,
  "dry_run": false,
  "schedule_confirmed": false,
  "skip_stages": [
    "research"
  ],
  "response_format": "json"
}

json

Example Responses

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

json

application/json

Check status of a pipeline run

POST

https://mcp.socialneuron.com/v1

/tools/get_pipeline_status

Check status of a pipeline run › Request Body

pipeline_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Pipeline run ID (omit for latest)

response_format

string · enum

Enum values:

text

json

Check status of a pipeline run › 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.

ToolResult

object[]

object

isError

boolean

Batch auto-approve posts meeting quality thresholds

POST

https://mcp.socialneuron.com/v1

/tools/auto_approve_plan

Batch auto-approve posts meeting quality thresholds › Request Body

plan_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Content plan ID

quality_threshold

number · min: 0 · max: 35

Minimum quality score to auto-approve

Default: 26

response_format

string · enum

Enum values:

text

json

Default: json

Batch auto-approve posts meeting quality thresholds › 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.

ToolResult

object[]

object

isError

boolean

media plan-approvals

Social Neuron REST API

pipeline

Pre-flight check before running a content pipeline

POST

https://mcp.socialneuron.com/v1

/tools/check_pipeline_readiness

Pre-flight check before running a content pipeline › Request Body

platforms

string[] · minItems: 1 · required

Target platforms to check

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Project ID (auto-detected if omitted)

estimated_posts

number · min: 1 · max: 50

Estimated posts to generate

Default: 5

response_format

string · enum

Response format

Enum values:

text

json

Pre-flight check before running a content pipeline › 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.

ToolResult

object[]

object

isError

boolean

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

POST

https://mcp.socialneuron.com/v1

/tools/run_content_pipeline

End-to-end content pipeline: plan → quality → approve → schedule › Request Body

platforms

string[] · minItems: 1 · required

Target platforms

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

project_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Project ID (auto-detected if omitted)

topic

string

Content topic (required if no source_url)

source_url

string

URL to extract content from

object

Exact connected-account ID per target platform. Required when a project has multiple accounts on one platform.

days

number · min: 1 · max: 7

Days to plan

Default: 5

posts_per_day

number · min: 1 · max: 3

Posts per platform per day

Default: 1

approval_mode

string · enum

auto: approve all passing quality. review_all: flag everything. review_low_confidence: auto-approve high scorers.

Enum values:

auto

review_all

review_low_confidence

Default: review_low_confidence

auto_approve_threshold

number · min: 0 · max: 35

Quality score threshold for auto-approval (used in auto/review_low_confidence modes)

Default: 28

max_credits

number

Credit budget cap

dry_run

boolean

If true, skip scheduling and return plan only

Default: false

schedule_confirmed

boolean

Required to schedule posts. Set true only after explicit user confirmation to publish/schedule.

Default: false

skip_stages

string[]

Stages to skip

Enum values:

research

quality

schedule

response_format

string · enum

Enum values:

text

json

Default: json

End-to-end content pipeline: plan → quality → approve → schedule › 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.

ToolResult

object[]

object

isError

boolean

POST/tools/run_content_pipeline

curl https://mcp.socialneuron.com/v1/tools/run_content_pipeline \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "topic": "topic",
  "source_url": "source_url",
  "platforms": [
    "youtube"
  ],
  "account_ids": {
    "key": "00000000-0000-0000-0000-000000000000"
  },
  "days": 5,
  "posts_per_day": 1,
  "approval_mode": "review_low_confidence",
  "auto_approve_threshold": 28,
  "max_credits": 0,
  "dry_run": false,
  "schedule_confirmed": false,
  "skip_stages": [
    "research"
  ],
  "response_format": "json"
}'

Example Request Body

{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "topic": "topic",
  "source_url": "source_url",
  "platforms": [
    "youtube"
  ],
  "account_ids": {
    "key": "00000000-0000-0000-0000-000000000000"
  },
  "days": 5,
  "posts_per_day": 1,
  "approval_mode": "review_low_confidence",
  "auto_approve_threshold": 28,
  "max_credits": 0,
  "dry_run": false,
  "schedule_confirmed": false,
  "skip_stages": [
    "research"
  ],
  "response_format": "json"
}

json

Example Responses

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

json

application/json

Check status of a pipeline run

POST

https://mcp.socialneuron.com/v1

/tools/get_pipeline_status

Check status of a pipeline run › Request Body

pipeline_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Pipeline run ID (omit for latest)

response_format

string · enum

Enum values:

text

json

Check status of a pipeline run › 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.

ToolResult

object[]

object

isError

boolean

Batch auto-approve posts meeting quality thresholds

POST

https://mcp.socialneuron.com/v1

/tools/auto_approve_plan

Batch auto-approve posts meeting quality thresholds › Request Body

plan_id

string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-… · required

Content plan ID

quality_threshold

number · min: 0 · max: 35

Minimum quality score to auto-approve

Default: 26

response_format

string · enum

Enum values:

text

json

Default: json

Batch auto-approve posts meeting quality thresholds › 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.

ToolResult

object[]

object

isError

boolean

media plan-approvals