hyperframes

POST

https://mcp.socialneuron.com/v1

/tools/list_hyperframes_blocks

category

string · enum

Filter by category. If omitted, returns all categories.

Enum values:

transition

social-overlay

data-viz

branding

decorative

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

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step

POST

https://mcp.socialneuron.com/v1

/tools/render_hyperframes

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › Request Body

duration_sec

number · min: 0.1 · max: 600 · required

Output duration in seconds. Required. Max 600 (10 min).

composition_html

string · maxLength: 500000

Inline HTML composition (full ...). Max 500KB. Use composition_url for larger.

composition_url

string

R2 URL pointing to a previously uploaded composition HTML file. Use this instead of composition_html for compositions > 500KB.

input_props

string

JSON string of props injected into the composition root via window.__hf.props.

aspect_ratio

string · enum

Output aspect ratio. Default "9:16".

Enum values:

9:16

16:9

1:1

Frames per second. Default 30.

quality

string · enum

draft: fast iteration; standard: production; high: final master.

Enum values:

draft

standard

high

project_id

string

Project ID to associate the Hyperframes render with.

response_format

string · enum

Response format. Use json for a stable job_id handoff.

Enum values:

text

json

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › 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/render_hyperframes

curl https://mcp.socialneuron.com/v1/tools/render_hyperframes \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "composition_html": "composition_html",
  "composition_url": "composition_url",
  "input_props": "input_props",
  "aspect_ratio": "9:16",
  "duration_sec": 0.1,
  "fps": 24,
  "quality": "draft",
  "project_id": "project_id",
  "response_format": "text"
}'

Example Request Body

{
  "composition_html": "composition_html",
  "composition_url": "composition_url",
  "input_props": "input_props",
  "aspect_ratio": "9:16",
  "duration_sec": 0.1,
  "fps": 24,
  "quality": "draft",
  "project_id": "project_id",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

extraction ideation

Social Neuron REST API

hyperframes

POST

https://mcp.socialneuron.com/v1

/tools/list_hyperframes_blocks

category

string · enum

Filter by category. If omitted, returns all categories.

Enum values:

transition

social-overlay

data-viz

branding

decorative

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

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step

POST

https://mcp.socialneuron.com/v1

/tools/render_hyperframes

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › Request Body

duration_sec

number · min: 0.1 · max: 600 · required

Output duration in seconds. Required. Max 600 (10 min).

composition_html

string · maxLength: 500000

Inline HTML composition (full ...). Max 500KB. Use composition_url for larger.

composition_url

string

R2 URL pointing to a previously uploaded composition HTML file. Use this instead of composition_html for compositions > 500KB.

input_props

string

JSON string of props injected into the composition root via window.__hf.props.

aspect_ratio

string · enum

Output aspect ratio. Default "9:16".

Enum values:

9:16

16:9

1:1

Frames per second. Default 30.

quality

string · enum

draft: fast iteration; standard: production; high: final master.

Enum values:

draft

standard

high

project_id

string

Project ID to associate the Hyperframes render with.

response_format

string · enum

Response format. Use json for a stable job_id handoff.

Enum values:

text

json

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › 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/render_hyperframes

curl https://mcp.socialneuron.com/v1/tools/render_hyperframes \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "composition_html": "composition_html",
  "composition_url": "composition_url",
  "input_props": "input_props",
  "aspect_ratio": "9:16",
  "duration_sec": 0.1,
  "fps": 24,
  "quality": "draft",
  "project_id": "project_id",
  "response_format": "text"
}'

Example Request Body

{
  "composition_html": "composition_html",
  "composition_url": "composition_url",
  "input_props": "input_props",
  "aspect_ratio": "9:16",
  "duration_sec": 0.1,
  "fps": 24,
  "quality": "draft",
  "project_id": "project_id",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

extraction ideation

hyperframes

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions › Request Body

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions › Responses

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › Request Body

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › Responses

hyperframes

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions › Request Body

List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) that can be composed into HTML video compositions › Responses

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › Request Body

Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines — frame-accurate, no React build step › Responses