Postly MCP

Upload Media

postly_upload_media

Imports media into Postly storage independently of a post mutation. Accepts a client-provided file reference, URL, data URL, or base64 payload. Returns a durable Postly media object only when complete; a 202 processing result requires a later list_media check with its idempotency_key before creating or scheduling a post.

Input Schema

TableJSON Schema

Name	Required	Description
`url`	No	Public or temporary URL to import into Postly storage when no file reference is available.
`data`	No	Base64 content or a data URL for agents that can provide bytes instead of a URL.
`file`	No	Client-provided file reference for an attached, selected, or generated file.
`type`	No	Optional MIME type such as image/png, video/mp4, or application/pdf.
`alt_text`	No	Optional alt text to carry forward into the returned Postly media object.
`file_name`	No	Optional file name. Required when using data/base64 without a file reference.
`workspace_id`	No	Destination Media Library workspace ID. Omit to use the oldest available writable workspace within this connection. Check media_library in the result for its workspace_id and registration status.
`idempotency_key`	No	Optional stable key for safely retrying the same upload. Postly derives one automatically for file references and URLs.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`code`	No
`media`	No
`usage`	No
`status`	No
`message`	No
`next_step`	No
`raw_upload`	No
`media_library`	No
`idempotency_key`	No
`retry_after_seconds`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 10, 2026

addedInput schema / properties / workspace_id

Added value: +{
+  "description": "Destination Media Library workspace ID. Omit to use the oldest available writable workspace within this connection. Check media_library in the result for its workspace_id and registration status.",
+  "type": "string"
+}

addedOutput schema / properties / media_library
```
Added value: +{
+  "type": "object"
+}
```

Changed4 schema fields changedSep 29, 2026
- addedOutput schema / properties / idempotency_key
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / next_step
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / retry_after_seconds
```
Added value: +{
+  "type": "integer"
+}
```
- addedOutput schema / properties / status
```
Added value: +{
+  "type": "string"
+}
```

Changed1 schema field changedSep 16, 2026

addedInput schema / properties / idempotency_key

Added value: +{
+  "description": "Optional stable key for safely retrying the same upload. Postly derives one automatically for file references and URLs.",
+  "type": "string"
+}

Changed1 schema field changedAug 1, 2026

changedInput schema / properties / file / description

Previous value: -"ChatGPT/OpenAI file reference for an attached, selected, or generated file. ChatGPT supplies this when the tool metadata marks file as an openai/fileParams field."New value: +"Client-provided file reference for an attached, selected, or generated file."

Changed1 schema field changedJul 8, 2026
- removedInput schema / properties / file / properties / download_url / format
```
Removed value: -"uri"
```
Changed1 schema field changedJun 4, 2026
- addedInput schema / properties / file / properties / download_url / format
```
Added value: +"uri"
```
First observedMay 19, 2026

TDQS

Score is being calculated.

All Postly MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?