Agent tools · configured contract

Tool overview

16 configured tools carry an agent from workspace status and destination setup through guidance, bounded planning, execution evidence, and measurement.

Exact tool names

Configured tools

The connected surface exposes exactly 16 tools. It includes setup status, account discovery, a human authorization handoff, and direct media upload; human approvals and credential management are not agent-callable.

01get_workspace_status

Start here to read setup progress, connection availability, accounts, policy, brief, and activity counts.

02list_accounts

List destination account IDs and connection state, synchronizing provider state into Postdom for this workspace.

03connect_account

Create a platform authorization URL for a human to complete when the workspace connection gate is unlocked.

04get_brief

Read the current workspace-owned brand guidance before planning or writing content.

05get_digest

Read the latest completed workspace week as descriptive evidence.

06get_learning

Read shared account learning: source-linked observations and exploratory advice for one learning scope.

07upload_media

Create a short-lived direct-upload contract for finished video bytes.

08get_media

Verify one uploaded media handle before publishing it.

09submit_plan

Propose a time-bounded publication plan for one human approval.

10get_plan

Read the current plan state and structured feedback from the human reviewer.

11publish_video

Submit finished media for immediate or UTC-scheduled execution using the current-source publish_video contract.

12get_publish

Read one post state, every destination outcome, and structured approval feedback.

13list_posts

List this workspace's posts to answer what is scheduled without already holding a post ID.

14get_performance

Read normalized measurements for one post or one connected account.

15get_best_posts

Rank one account's posts by one evidence-backed metric over a requested window.

16create_slideshow

Render carousel slides on the workspace brand kit from words and images, and store each slide as image media.

Recommended sequence

Canonical loop

STARTget_workspace_status
Read setup progress and the exact connection gate before acting.
DISCOVERlist_accounts
Read connected destination IDs without guessing.
HANDOFFconnect_account
Create an authorization URL for the human when the workspace gate is unlocked.
READget_brief
Read workspace-owned brand guidance before planning or writing.
LEARNget_digest
Read the latest completed week with its populations, cadence endings, and coverage gaps.
UPLOADupload_media
Create a short-lived contract and PUT finished bytes directly to Postdom-owned storage.
VERIFYget_media
Continue only after the media handle reaches stored.
IF NEEDEDsubmit_plan
Propose bounded authority when account policy requires plan-level review.
IF USEDget_plan
Wait for exact state and structured feedback.
EXECUTEpublish_video
Submit finished media inside configured authority.
OBSERVEget_publish
Separate post state from destination outcomes.
MEASUREget_performance
Return normalized values with availability evidence.
COMPAREget_best_posts
Rank only evidence-backed values and preserve exclusion reasons.

Postdom Chat only

Chat rules tools

3 more tools exist for Postdom Chat and not for a connected agent. They change the workspace's rules and the brief's Voice and Never do sections through the same versioned writes the Rules page uses, with the signed-in owner's or admin's authority, and answer every change as a before → after card. They are not on the MCP menu: the routes they write through refuse every agent credential, so an agent that needs a rule changed asks the human.

17set_approval_rule

Change when Postdom asks the person before posting, or pause posting, for the whole workspace or for one connected account.

18set_posting_limits

Set how many posts a day Postdom may make and the quiet hours in which nothing goes out, for the whole workspace or for one connected account.

19set_brand_notes

Rewrite the Voice section and/or the Never do section of the workspace brief in the person's words, leaving every other section as it is.

Current availability

Access boundary

Workspace key required

A human creates the workspace and one-time agent key in Accounts, then pastes the generated MCP configuration. Agents can then upload finished video directly to workspace-scoped storage.

Inspect the connected schemas before every call. Stop when a required account ID, stored media handle or accepted URL, credential, or human decision is missing.