Social Neuron REST API
string · enumnumber · min: 1 · max: 90number · min: 1 · max: 50stringstring · enum
string · enumnumber · min: 1 · max: 90stringstring · enum
insights
Get AI-generated performance insights
POST
https://mcp.socialneuron.com/v1
/tools/get_performance_insights
Get AI-generated performance insights › Request Body
insight_typeFilter to a specific insight type.
Enum values:
top_hooks
optimal_timing
best_models
competitor_patterns
daysNumber of days to look back. Defaults to 30. Max 90.
limitMaximum number of insights to return. Defaults to 10.
project_idProject ID. Defaults to the active project context.
response_formatOptional response format. Defaults to text.
Enum values:
text
json
Get AI-generated performance insights › 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.
object[]
object
isErrorGet recommended posting times based on audience data
POST
https://mcp.socialneuron.com/v1
/tools/get_best_posting_times
Get recommended posting times based on audience data › Request Body
platformFilter to a specific platform.
Enum values:
youtube
tiktok
instagram
twitter
linkedin
facebook
threads
bluesky
daysNumber of days to analyze. Defaults to 30. Max 90.
project_idProject ID. Defaults to the active project context.
response_formatOptional response format. Defaults to text.
Enum values:
text
json
Get recommended posting times based on audience data › 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.
object[]
object
isError