comments

List YouTube comments on published videos (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/list_comments

List YouTube comments on published videos (YouTube only today) › Request Body

video_id

string

YouTube video ID — the 11-character string from the URL (e.g. "dQw4w9WgXcQ" from youtube.com/watch?v=dQw4w9WgXcQ). Omit to get recent comments across all channel videos.

max_results

number · min: 1 · max: 100

Maximum number of comments to return. Defaults to 50.

page_token

string

Pagination cursor from previous list_comments response nextPageToken field. Omit for first page of results.

connected_account_id

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

Exact YouTube connected-account ID from list_connections. Optional when exactly one active YouTube account is bound to the resolved project — auto-resolved. Required (with a clear list of candidates) when the project has multiple YouTube accounts.

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

List YouTube comments on published videos (YouTube only today) › 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/list_comments

curl https://mcp.socialneuron.com/v1/tools/list_comments \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "video_id": "video_id",
  "max_results": 1,
  "page_token": "page_token",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "video_id": "video_id",
  "max_results": 1,
  "page_token": "page_token",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Reply to a YouTube comment (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/reply_to_comment

Reply to a YouTube comment (YouTube only today) › Request Body

parent_id

string · required

The ID of the parent comment to reply to (from list_comments).

text

string · minLength: 1 · required

The reply text.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Reply to a YouTube comment (YouTube only today) › 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/reply_to_comment

curl https://mcp.socialneuron.com/v1/tools/reply_to_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "parent_id": "parent_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "parent_id": "parent_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Post a new YouTube comment (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/post_comment

Post a new YouTube comment (YouTube only today) › Request Body

video_id

string · required

The YouTube video ID to comment on.

text

string · minLength: 1 · required

The comment text.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Post a new YouTube comment (YouTube only today) › 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/post_comment

curl https://mcp.socialneuron.com/v1/tools/post_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "video_id": "video_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "video_id": "video_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Moderate a YouTube comment (approve/hide/flag) (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/moderate_comment

Moderate a YouTube comment (approve/hide/flag) (YouTube only today) › Request Body

comment_id

string · required

The comment ID to moderate.

moderation_status

string · enum · required

"published" to approve, "rejected" to hide.

Enum values:

published

rejected

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Moderate a YouTube comment (approve/hide/flag) (YouTube only today) › 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/moderate_comment

curl https://mcp.socialneuron.com/v1/tools/moderate_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "comment_id": "comment_id",
  "moderation_status": "published",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "comment_id": "comment_id",
  "moderation_status": "published",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Delete a YouTube comment (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/delete_comment

Delete a YouTube comment (YouTube only today) › Request Body

comment_id

string · required

The comment ID to delete.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Delete a YouTube comment (YouTube only today) › 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/delete_comment

curl https://mcp.socialneuron.com/v1/tools/delete_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "comment_id": "comment_id",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "comment_id": "comment_id",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

carousel content

Social Neuron REST API

comments

List YouTube comments on published videos (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/list_comments

List YouTube comments on published videos (YouTube only today) › Request Body

video_id

string

YouTube video ID — the 11-character string from the URL (e.g. "dQw4w9WgXcQ" from youtube.com/watch?v=dQw4w9WgXcQ). Omit to get recent comments across all channel videos.

max_results

number · min: 1 · max: 100

Maximum number of comments to return. Defaults to 50.

page_token

string

Pagination cursor from previous list_comments response nextPageToken field. Omit for first page of results.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

List YouTube comments on published videos (YouTube only today) › 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/list_comments

curl https://mcp.socialneuron.com/v1/tools/list_comments \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "video_id": "video_id",
  "max_results": 1,
  "page_token": "page_token",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "video_id": "video_id",
  "max_results": 1,
  "page_token": "page_token",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Reply to a YouTube comment (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/reply_to_comment

Reply to a YouTube comment (YouTube only today) › Request Body

parent_id

string · required

The ID of the parent comment to reply to (from list_comments).

text

string · minLength: 1 · required

The reply text.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Reply to a YouTube comment (YouTube only today) › 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/reply_to_comment

curl https://mcp.socialneuron.com/v1/tools/reply_to_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "parent_id": "parent_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "parent_id": "parent_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Post a new YouTube comment (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/post_comment

Post a new YouTube comment (YouTube only today) › Request Body

video_id

string · required

The YouTube video ID to comment on.

text

string · minLength: 1 · required

The comment text.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Post a new YouTube comment (YouTube only today) › 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/post_comment

curl https://mcp.socialneuron.com/v1/tools/post_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "video_id": "video_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "video_id": "video_id",
  "text": "text",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Moderate a YouTube comment (approve/hide/flag) (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/moderate_comment

Moderate a YouTube comment (approve/hide/flag) (YouTube only today) › Request Body

comment_id

string · required

The comment ID to moderate.

moderation_status

string · enum · required

"published" to approve, "rejected" to hide.

Enum values:

published

rejected

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Moderate a YouTube comment (approve/hide/flag) (YouTube only today) › 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/moderate_comment

curl https://mcp.socialneuron.com/v1/tools/moderate_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "comment_id": "comment_id",
  "moderation_status": "published",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "comment_id": "comment_id",
  "moderation_status": "published",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Delete a YouTube comment (YouTube only today)

POST

https://mcp.socialneuron.com/v1

/tools/delete_comment

Delete a YouTube comment (YouTube only today) › Request Body

comment_id

string · required

The comment ID to delete.

connected_account_id

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

project_id

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

Exact brand/project ID. Defaults only when the authenticated user has one project.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Delete a YouTube comment (YouTube only today) › 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/delete_comment

curl https://mcp.socialneuron.com/v1/tools/delete_comment \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "comment_id": "comment_id",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}'

Example Request Body

{
  "comment_id": "comment_id",
  "connected_account_id": "00000000-0000-0000-0000-000000000000",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

carousel content