Skip to content

Post programs: publish, schedule, withdraw

The Post Verbs publish, schedule, withdraw as MCP do programs, with inputs, result, refusals and an example.

Reference for Post, one group of Post programs.

Post.publish

Publish sends a Post out through its Handle once every claim it states resolves to a live record. Verb page.

Text
do: return await $.Post.publish(input)

Emits Post.published.

Inputs

InputTypeRequiredDescription
postPostrequiredThe Post to publish.

Returns

OutputTypeRequiredDescription
postPostrequiredThe published Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Post.publish({ post: 'post_HiXn57rBdP' })"
  }
}

Post.schedule

Schedule puts a drafted Post on its Handle’s calendar for a set time. Verb page.

Text
do: return await $.Post.schedule(input)

Emits Post.scheduled.

Inputs

InputTypeRequiredDescription
postPostrequiredThe drafted Post.
atdatetimerequiredWhen it goes out.

Returns

OutputTypeRequiredDescription
postPostrequiredThe scheduled Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Post.schedule({ post: 'post_HiXn57rBdP', at: '2026-10-22T12:00:00Z' })"
  }
}

Post.withdraw

Withdraw takes a published Post down from its venue and keeps the record, its reach and its replies. Verb page.

Text
do: return await $.Post.withdraw(input)

Emits Post.withdrawn.

Inputs

InputTypeRequiredDescription
postPostrequiredThe Post to take down.
reasontextrequiredWhy it comes down.

Returns

OutputTypeRequiredDescription
postPostrequiredThe withdrawn Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Post.withdraw({ post: 'post_HiXn57rBdP', reason: 'Example reason' })"
  }
}