Postkey: Instagram DM Automation and Comment-to-DM

Start a video edit

postkey_start_edit

Postkey: Starts a new video edit from the person's footage, so they can only shoot and you do the rest. Give library_item_ids (videos from postkey_list_library, or postkey_begin_upload or postkey_request_file for a new one), or leave them out and give clips on this computer to the command. Answers with a start link and the command that uses it: run it on a computer with Node 22 or newer and Google Chrome, where the clips are read and heard, and it prints the new edit's id. Then read it with postkey_get_edit and cut it with postkey_edit_video. No computer to run it on: tell the person to open Postkey's editor on a computer and pick the video under From your Library. Steps: postkey_guide topic render. A video over 10 minutes becomes a long edit; from_edit plus clips then makes short edits from it at once, nothing to run.

Input Schema

Name	Required	Description
`brief`	No	What this reel is for: the mood, the platform, what to avoid.
`clips`	No	With from_edit: the moments to make into short edits, each its own edit. postkey_guide topic render, Clips from a long video.
`roles`	No	In a format with parts: the part each clip is, in order. Default: by position.
`shape`	No	9:16 (default) for Reels, TikTok, Shorts; 4:5 or 1:1 for feeds; 16:9 for YouTube, LinkedIn. set_shape changes it.
`title`	No	The edit's name. Default: the first words said.
`words`	No	Names and terms to spell right: the person's name, brand, products, handles ("Postkey", "@austinwhite"). Default: the profile's list. set_words changes it.
`format`	No	A format id from postkey_list_edit_templates. Default talking. A saved template goes on afterwards with apply_template.
`captions`	No	Default: on, unless the footage already carries captions.
`headline`	No	Default: on, unless the footage already carries captions.
`language`	No	Language spoken: es, ja or auto
`from_edit`	No	A long video's edit (postkey_get_edit says long: true). Send with clips instead of library_item_ids.
`tightness`	No	How many pauses to cut, as in set_tightness. off leaves the cut alone. Default: the format's.
`any_length`	No	With from_edit: allow clips under 10 seconds or over 3 minutes.
`cut_fillers`	No	Cut um, uh, filler like (English)
`library_item_ids`	No	Library videos, in the order they play, and any sound recorded on its own mic (lined up with its video). Up to 10. Leave out to use files on this computer.

Output Schema

Name	Required	Description
`ok`	Yes	false: refused (isError; code, message, guide_topic, url); no change.
`link`	No	The signed start link. Works for an hour. Treat it like a password.
`note`	No	What happens next.
`script`	No	Where to download the program that runs the link.
`command`	No	The command to run on a computer with Node 22 or newer and Google Chrome. It prints the new edit's id as JSON.
`footage`	No	The Library videos it will read: library_item_id, title.
`available`	No	false: this server hands out no start links; the person starts the edit on a computer.
`expires_in_minutes`	No	How long the link works.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedNov 9, 2026

changedInput schema / properties / shape / description

Previous value: -"9:16 (default) for Reels, TikTok, Shorts; 1:1 for feeds; 16:9 for YouTube, LinkedIn. set_shape changes it."New value: +"9:16 (default) for Reels, TikTok, Shorts; 4:5 or 1:1 for feeds; 16:9 for YouTube, LinkedIn. set_shape changes it."

changedInput schema / properties / shape / enum

Previous value: -[
-  "9:16",
-  "1:1",
-  "16:9"
-]New value: +[
+  "9:16",
+  "4:5",
+  "1:1",
+  "16:9"
+]

Changed1 schema field changedNov 9, 2026

changedOutput schema / properties / ok / description

Previous value: -"false: refused (isError true; code, message, guide_topic, url), nothing changed."New value: +"false: refused (isError; code, message, guide_topic, url); no change."

Changed3 schema fields changedNov 6, 2026

addedInput schema / properties / cut_fillers

Added value: +{
+  "description": "Cut um, uh, filler like (English)",
+  "type": "boolean"
+}

changedInput schema / properties / shape / description

Previous value: -"The finished video: 9:16 (default) for Reels, TikTok and Shorts, 1:1 for feeds, 16:9 for YouTube and LinkedIn. Change it later with set_shape."New value: +"9:16 (default) for Reels, TikTok, Shorts; 1:1 for feeds; 16:9 for YouTube, LinkedIn. set_shape changes it."

changedInput schema / properties / words / description

Previous value: -"Names and terms the speech model must spell right: the person's name, brand, products, handles (\"Postkey\", \"@austinwhite\"). Default: the profile's own list. Kept on the edit; set_words changes it."New value: +"Names and terms to spell right: the person's name, brand, products, handles (\"Postkey\", \"@austinwhite\"). Default: the profile's list. set_words changes it."

Changed1 schema field changedNov 6, 2026

addedInput schema / properties / language

Added value: +{
+  "description": "Language spoken: es, ja or auto",
+  "maxLength": 8,
+  "type": "string"
+}

Changed1 schema field changedNov 6, 2026

addedInput schema / properties / words

Added value: +{
+  "description": "Names and terms the speech model must spell right: the person's name, brand, products, handles (\"Postkey\", \"@austinwhite\"). Default: the profile's own list. Kept on the edit; set_words changes it.",
+  "items": {
+    "maxLength": 40,
+    "minLength": 2,
+    "type": "string"
+  },
+  "maxItems": 50,
+  "type": "array"
+}

Changed1 schema field changedNov 6, 2026

changedInput schema / properties / library_item_ids / description

Previous value: -"Library videos, in the order they play. Up to 10. Leave out to use files on this computer."New value: +"Library videos, in the order they play, and any sound recorded on its own mic (lined up with its video). Up to 10. Leave out to use files on this computer."

Changed1 schema field changedNov 5, 2026

addedInput schema / properties / shape

Added value: +{
+  "description": "The finished video: 9:16 (default) for Reels, TikTok and Shorts, 1:1 for feeds, 16:9 for YouTube and LinkedIn. Change it later with set_shape.",
+  "enum": [
+    "9:16",
+    "1:1",
+    "16:9"
+  ],
+  "type": "string"
+}

Changed3 schema fields changedNov 5, 2026

addedInput schema / properties / any_length

Added value: +{
+  "description": "With from_edit: allow clips under 10 seconds or over 3 minutes.",
+  "type": "boolean"
+}

addedInput schema / properties / clips

Added value: +{
+  "description": "With from_edit: the moments to make into short edits, each its own edit. postkey_guide topic render, Clips from a long video.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "description": "The first sentence id it plays.",
+        "maxLength": 8,
+        "type": "string"
+      },
+      "reason": {
+        "description": "One sentence: why this one, for the person.",
+        "maxLength": 300,
+        "type": "string"
+      },
+      "score": {
+        "description": "{ hook, flow, value, trend }, each 0 to 100.",
+        "type": "object"
+      },
+      "title": {
+        "description": "What the clip says, in a few words.",
+        "maxLength": 100,
+        "type": "string"
+      },
+      "to": {
+        "description": "The last sentence id it plays: one that finishes the thought.",
+        "maxLength": 8,
+        "type": "string"
+      }
+    },
+    "required": [
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  "maxItems": 10,
+  "type": "array"
+}

addedInput schema / properties / from_edit

Added value: +{
+  "description": "A long video's edit (postkey_get_edit says long: true). Send with clips instead of library_item_ids.",
+  "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
+  "type": "string"
+}

AddedNov 1, 2026

TDQS

Score is being calculated.

All Postkey: Instagram DM Automation and Comment-to-DM 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?