Brand

Brand tools (scope: mcp:read/write, credits: ~0-3)

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo.

POST

https://api.socialneuron.com

/v1/tools/extract_brand

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. Uses AI-powered analysis of the page HTML. Useful for understanding a brand before generating content for it. Costs ~0-3 credits.

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. › Request Body

url

string · uri · required

The website URL to analyze for brand identity ' + '(e.g. "https://example.com").

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. › Responses

Successful tool execution.

object[]

Load the active persisted brand profile for a project from brand_profiles.

POST

https://api.socialneuron.com

/v1/tools/get_brand_profile

Load the active persisted brand profile for a project from brand_profiles. Costs ~0-3 credits.

Load the active persisted brand profile for a project from brand_profiles. › Request Body

project_id

string · uuid

Project ID. Defaults to active project context.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Load the active persisted brand profile for a project from brand_profiles. › Responses

Successful tool execution.

object[]

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc.

POST

https://api.socialneuron.com

/v1/tools/save_brand_profile

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc. Use after extract_brand has produced a draft AND the user has reviewed it, or when the user explicitly edits the profile. brand_context is the full profile payload from extract_brand or get_brand_profile. project_id defaults to the active project context. Overwrites the previous active profile (one per project) — pass the complete profile, no merge semantics. Use change_summary to leave an audit trail. Costs ~0-3 credits.

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc. › Request Body

brand_context

string · required

Brand context payload to save to brand_profiles.brand_context.

project_id

string · uuid

Project ID. Defaults to active project context.

change_summary

string

Optional summary of changes.

changed_paths

string

Optional changed path list.

source_url

string · uri

Optional source URL for provenance.

extraction_method

string · enum

Extraction method metadata.

Enum values:

manual

url_extract

business_profiler

product_showcase

overall_confidence

number

Optional overall confidence score in range 0..1.

extraction_metadata

string

response_format

string · enum

Enum values:

text

json

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc. › Responses

Successful tool execution.

object[]

POST/v1/tools/save_brand_profile

curl --request POST \
  --url https://api.socialneuron.com/v1/tools/save_brand_profile \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "brand_context": "brand_context",
  "change_summary": "change_summary",
  "changed_paths": "changed_paths",
  "source_url": "https://www.example.com/path/to/resource",
  "extraction_method": "manual",
  "overall_confidence": 0,
  "extraction_metadata": "extraction_metadata",
  "response_format": "text"
}
'

shell

Example Request Body

{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "brand_context": "brand_context",
  "change_summary": "change_summary",
  "changed_paths": "changed_paths",
  "source_url": "https://www.example.com/path/to/resource",
  "extraction_method": "manual",
  "overall_confidence": 0,
  "extraction_metadata": "extraction_metadata",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ]
}

json

application/json

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy).

POST

https://api.socialneuron.com

/v1/tools/update_platform_voice

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). Costs ~0-3 credits.

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). › Request Body

platform

string · enum · required

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

project_id

string · uuid

Project ID. Defaults to active project context.

samples

string

3-5 real platform post examples for style anchoring.

tone

string

style

string

avoid_patterns

string

hashtag_strategy

string

cta_style

string

response_format

string · enum

Enum values:

text

json

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). › Responses

Successful tool execution.

object[]

POST/v1/tools/update_platform_voice

curl --request POST \
  --url https://api.socialneuron.com/v1/tools/update_platform_voice \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "youtube",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "samples": "samples",
  "tone": "tone",
  "style": "style",
  "avoid_patterns": "avoid_patterns",
  "hashtag_strategy": "hashtag_strategy",
  "cta_style": "cta_style",
  "response_format": "text"
}
'

shell

Example Request Body

{
  "platform": "youtube",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "samples": "samples",
  "tone": "tone",
  "style": "style",
  "avoid_patterns": "avoid_patterns",
  "hashtag_strategy": "hashtag_strategy",
  "cta_style": "cta_style",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ]
}

json

application/json

Autopilot brandRuntime

Social Neuron MCP Tools API

Brand

Brand tools (scope: mcp:read/write, credits: ~0-3)

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo.

POST

https://api.socialneuron.com

/v1/tools/extract_brand

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. › Request Body

url

string · uri · required

The website URL to analyze for brand identity ' + '(e.g. "https://example.com").

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. › Responses

Successful tool execution.

object[]

Load the active persisted brand profile for a project from brand_profiles.

POST

https://api.socialneuron.com

/v1/tools/get_brand_profile

Load the active persisted brand profile for a project from brand_profiles. Costs ~0-3 credits.

Load the active persisted brand profile for a project from brand_profiles. › Request Body

project_id

string · uuid

Project ID. Defaults to active project context.

response_format

string · enum

Optional response format. Defaults to text.

Enum values:

text

json

Load the active persisted brand profile for a project from brand_profiles. › Responses

Successful tool execution.

object[]

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc.

POST

https://api.socialneuron.com

/v1/tools/save_brand_profile

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc. › Request Body

brand_context

string · required

Brand context payload to save to brand_profiles.brand_context.

project_id

string · uuid

Project ID. Defaults to active project context.

change_summary

string

Optional summary of changes.

changed_paths

string

Optional changed path list.

source_url

string · uri

Optional source URL for provenance.

extraction_method

string · enum

Extraction method metadata.

Enum values:

manual

url_extract

business_profiler

product_showcase

overall_confidence

number

Optional overall confidence score in range 0..1.

extraction_metadata

string

response_format

string · enum

Enum values:

text

json

Save (or replace) the active brand profile for a project — voice, target audience, content pillars, claims, etc. › Responses

Successful tool execution.

object[]

POST/v1/tools/save_brand_profile

curl --request POST \
  --url https://api.socialneuron.com/v1/tools/save_brand_profile \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "brand_context": "brand_context",
  "change_summary": "change_summary",
  "changed_paths": "changed_paths",
  "source_url": "https://www.example.com/path/to/resource",
  "extraction_method": "manual",
  "overall_confidence": 0,
  "extraction_metadata": "extraction_metadata",
  "response_format": "text"
}
'

shell

Example Request Body

{
  "project_id": "00000000-0000-0000-0000-000000000000",
  "brand_context": "brand_context",
  "change_summary": "change_summary",
  "changed_paths": "changed_paths",
  "source_url": "https://www.example.com/path/to/resource",
  "extraction_method": "manual",
  "overall_confidence": 0,
  "extraction_metadata": "extraction_metadata",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ]
}

json

application/json

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy).

POST

https://api.socialneuron.com

/v1/tools/update_platform_voice

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). Costs ~0-3 credits.

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). › Request Body

platform

string · enum · required

Enum values:

youtube

tiktok

instagram

twitter

facebook

threads

bluesky

project_id

string · uuid

Project ID. Defaults to active project context.

samples

string

3-5 real platform post examples for style anchoring.

tone

string

style

string

avoid_patterns

string

hashtag_strategy

string

cta_style

string

response_format

string · enum

Enum values:

text

json

Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). › Responses

Successful tool execution.

object[]

POST/v1/tools/update_platform_voice

curl --request POST \
  --url https://api.socialneuron.com/v1/tools/update_platform_voice \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "youtube",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "samples": "samples",
  "tone": "tone",
  "style": "style",
  "avoid_patterns": "avoid_patterns",
  "hashtag_strategy": "hashtag_strategy",
  "cta_style": "cta_style",
  "response_format": "text"
}
'

shell

Example Request Body

{
  "platform": "youtube",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "samples": "samples",
  "tone": "tone",
  "style": "style",
  "avoid_patterns": "avoid_patterns",
  "hashtag_strategy": "hashtag_strategy",
  "cta_style": "cta_style",
  "response_format": "text"
}

json

Example Responses

{
  "content": [
    {
      "type": "text",
      "text": "text"
    }
  ]
}

json

application/json

Autopilot brandRuntime