autopilot

List autopilot configurations

POST

https://mcp.socialneuron.com/v1

/tools/list_autopilot_configs

List autopilot configurations › Request Body

active_only

boolean

If true, only return active configs. Defaults to false (show all).

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

List autopilot configurations › 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

Update autopilot configuration

POST

https://mcp.socialneuron.com/v1

/tools/update_autopilot_config

Update autopilot configuration › Request Body

config_id

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

The autopilot config ID to update.

is_active

boolean

Enable or disable this autopilot config.

schedule_days

string[]

Days of the week to run (e.g., ["mon", "wed", "fri"]).

Enum values:

mon

tue

wed

thu

fri

sat

sun

schedule_time

string

Time to run in HH:MM format (24h, user timezone). E.g., "09:00".

max_credits_per_run

number

Maximum credits per execution.

max_credits_per_week

number

Maximum credits per week.

Update autopilot configuration › 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/update_autopilot_config

curl https://mcp.socialneuron.com/v1/tools/update_autopilot_config \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "config_id": "00000000-0000-0000-0000-000000000000",
  "is_active": true,
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0
}'

Example Request Body

{
  "config_id": "00000000-0000-0000-0000-000000000000",
  "is_active": true,
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0
}

json

Example Responses

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

json

application/json

Get current autopilot status

POST

https://mcp.socialneuron.com/v1

/tools/get_autopilot_status

Get current autopilot status › Request Body

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Get current autopilot status › 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

Create a new autopilot configuration

POST

https://mcp.socialneuron.com/v1

/tools/create_autopilot_config

Create a new autopilot configuration › Request Body

name

string · minLength: 1 · maxLength: 100 · required

Name for this autopilot config

project_id

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

Project to run autopilot for

schedule_days

string[] · minItems: 1 · required

Days of the week to run

Enum values:

mon

tue

wed

thu

fri

sat

sun

schedule_time

string · required

Time to run in HH:MM format (24h). E.g., "09:00"

mode

string · enum

Mode: recipe (legacy) or pipeline (new orchestration)

Enum values:

recipe

pipeline

Default: pipeline

timezone

string

Timezone (e.g., "America/New_York"). Defaults to UTC.

max_credits_per_run

number · min: 0

Maximum credits per execution

max_credits_per_week

number · min: 0

Maximum credits per week

approval_mode

string · enum

How to handle post approvals

Enum values:

auto

review_all

review_low_confidence

Default: review_low_confidence

is_active

boolean

Whether to activate immediately

Default: true

response_format

string · enum

Response format. Defaults to text.

Enum values:

text

json

Create a new autopilot configuration › 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/create_autopilot_config

curl https://mcp.socialneuron.com/v1/tools/create_autopilot_config \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "mode": "pipeline",
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "timezone": "timezone",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0,
  "approval_mode": "review_low_confidence",
  "is_active": true,
  "response_format": "text"
}'

Example Request Body

{
  "name": "name",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "mode": "pipeline",
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "timezone": "timezone",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0,
  "approval_mode": "review_low_confidence",
  "is_active": true,
  "response_format": "text"
}

json

Example Responses

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

json

application/json

apps brand

Social Neuron REST API

autopilot

List autopilot configurations

POST

https://mcp.socialneuron.com/v1

/tools/list_autopilot_configs

List autopilot configurations › Request Body

active_only

boolean

If true, only return active configs. Defaults to false (show all).

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

List autopilot configurations › 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

Update autopilot configuration

POST

https://mcp.socialneuron.com/v1

/tools/update_autopilot_config

Update autopilot configuration › Request Body

config_id

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

The autopilot config ID to update.

is_active

boolean

Enable or disable this autopilot config.

schedule_days

string[]

Days of the week to run (e.g., ["mon", "wed", "fri"]).

Enum values:

mon

tue

wed

thu

fri

sat

sun

schedule_time

string

Time to run in HH:MM format (24h, user timezone). E.g., "09:00".

max_credits_per_run

number

Maximum credits per execution.

max_credits_per_week

number

Maximum credits per week.

Update autopilot configuration › 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/update_autopilot_config

curl https://mcp.socialneuron.com/v1/tools/update_autopilot_config \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "config_id": "00000000-0000-0000-0000-000000000000",
  "is_active": true,
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0
}'

Example Request Body

{
  "config_id": "00000000-0000-0000-0000-000000000000",
  "is_active": true,
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0
}

json

Example Responses

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

json

application/json

Get current autopilot status

POST

https://mcp.socialneuron.com/v1

/tools/get_autopilot_status

Get current autopilot status › Request Body

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Get current autopilot status › 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

Create a new autopilot configuration

POST

https://mcp.socialneuron.com/v1

/tools/create_autopilot_config

Create a new autopilot configuration › Request Body

name

string · minLength: 1 · maxLength: 100 · required

Name for this autopilot config

project_id

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

Project to run autopilot for

schedule_days

string[] · minItems: 1 · required

Days of the week to run

Enum values:

mon

tue

wed

thu

fri

sat

sun

schedule_time

string · required

Time to run in HH:MM format (24h). E.g., "09:00"

mode

string · enum

Mode: recipe (legacy) or pipeline (new orchestration)

Enum values:

recipe

pipeline

Default: pipeline

timezone

string

Timezone (e.g., "America/New_York"). Defaults to UTC.

max_credits_per_run

number · min: 0

Maximum credits per execution

max_credits_per_week

number · min: 0

Maximum credits per week

approval_mode

string · enum

How to handle post approvals

Enum values:

auto

review_all

review_low_confidence

Default: review_low_confidence

is_active

boolean

Whether to activate immediately

Default: true

response_format

string · enum

Response format. Defaults to text.

Enum values:

text

json

Create a new autopilot configuration › 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/create_autopilot_config

curl https://mcp.socialneuron.com/v1/tools/create_autopilot_config \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "name",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "mode": "pipeline",
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "timezone": "timezone",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0,
  "approval_mode": "review_low_confidence",
  "is_active": true,
  "response_format": "text"
}'

Example Request Body

{
  "name": "name",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "mode": "pipeline",
  "schedule_days": [
    "mon"
  ],
  "schedule_time": "schedule_time",
  "timezone": "timezone",
  "max_credits_per_run": 0,
  "max_credits_per_week": 0,
  "approval_mode": "review_low_confidence",
  "is_active": true,
  "response_format": "text"
}

json

Example Responses

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

json

application/json

apps brand