media

Upload local file or external URL to R2 storage

POST

https://mcp.socialneuron.com/v1

/tools/upload_media

Upload local file or external URL to R2 storage › Request Body

source

string

Local file path (e.g. "/Users/me/image.png") or public URL (e.g. "https://example.com/photo.jpg"). Leave empty when passing file_data instead.

file_data

string

Base64-encoded file bytes, with or without a "data:;base64," prefix. Use this from remote agents (Claude Web/Desktop) that cannot provide a filesystem path. Max 10MB decoded.

file_name

string

Optional filename for the upload (e.g. "hero.png"). Path components are stripped — only the basename is used.

content_type

string

MIME type (e.g. "image/png", "video/mp4"). Auto-detected from file extension for paths/URLs, or from the data: prefix on file_data. Required when passing raw base64 with no prefix.

project_id

string

Project ID for R2 path organization.

response_format

string · enum

Response format. Default: text.

Enum values:

text

json

Upload local file or external URL to R2 storage › 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/upload_media

curl https://mcp.socialneuron.com/v1/tools/upload_media \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "source": "source",
  "file_data": "file_data",
  "file_name": "file_name",
  "content_type": "content_type",
  "project_id": "project_id",
  "response_format": "text"
}'

Example Request Body

{
  "source": "source",
  "file_data": "file_data",
  "file_name": "file_name",
  "content_type": "content_type",
  "project_id": "project_id",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Sign an R2 key to get a fresh download URL

POST

https://mcp.socialneuron.com/v1

/tools/get_media_url

Sign an R2 key to get a fresh download URL › Request Body

r2_key

string · required

The R2 object key (e.g. "org_x/user_y/images/2026-04-03/abc.png").

response_format

string · enum

Response format. Default: text.

Enum values:

text

json

Sign an R2 key to get a fresh download URL › 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

loop-summary pipeline

Social Neuron REST API

media

Upload local file or external URL to R2 storage

POST

https://mcp.socialneuron.com/v1

/tools/upload_media

Upload local file or external URL to R2 storage › Request Body

source

string

Local file path (e.g. "/Users/me/image.png") or public URL (e.g. "https://example.com/photo.jpg"). Leave empty when passing file_data instead.

file_data

string

Base64-encoded file bytes, with or without a "data:;base64," prefix. Use this from remote agents (Claude Web/Desktop) that cannot provide a filesystem path. Max 10MB decoded.

file_name

string

Optional filename for the upload (e.g. "hero.png"). Path components are stripped — only the basename is used.

content_type

string

MIME type (e.g. "image/png", "video/mp4"). Auto-detected from file extension for paths/URLs, or from the data: prefix on file_data. Required when passing raw base64 with no prefix.

project_id

string

Project ID for R2 path organization.

response_format

string · enum

Response format. Default: text.

Enum values:

text

json

Upload local file or external URL to R2 storage › 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/upload_media

curl https://mcp.socialneuron.com/v1/tools/upload_media \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "source": "source",
  "file_data": "file_data",
  "file_name": "file_name",
  "content_type": "content_type",
  "project_id": "project_id",
  "response_format": "text"
}'

Example Request Body

{
  "source": "source",
  "file_data": "file_data",
  "file_name": "file_name",
  "content_type": "content_type",
  "project_id": "project_id",
  "response_format": "text"
}

json

Example Responses

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

json

application/json

Sign an R2 key to get a fresh download URL

POST

https://mcp.socialneuron.com/v1

/tools/get_media_url

Sign an R2 key to get a fresh download URL › Request Body

r2_key

string · required

The R2 object key (e.g. "org_x/user_y/images/2026-04-03/abc.png").

response_format

string · enum

Response format. Default: text.

Enum values:

text

json

Sign an R2 key to get a fresh download URL › 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

loop-summary pipeline