Configured tool · read-only
get_performance
Read normalized measurements for one post or one connected account.
Human and agent roles
Configured boundary
Configured workspace
Provide exactly one scope identifier. Preserve every number, every absent field, and the reason each absent field has no value.
This reference describes a connection made with @postdom/mcp@0.4.0 and a workspace-scoped agent key created in Accounts.
Callable schema
Input fields
Field names match the configured tool schema. Runtime-only constraints are labeled separately from schema validation.
post_idOptionalstringReads stored destination snapshots for one post.
account_idOptionalstringReads snapshots for one connected account.
windowOptional7d | 30dApplies only to account reads. It does not change post-scoped reads.
limitOptionalintegerCaps how many of the most recent snapshots the answer carries.
Synthetic values
Example call
Identifiers and values are examples. They do not represent a connected workspace or accepted media source.
get_performance({
post_id: "post_example_08"
})Configured behavior
Read modes
The tool selects one of two read paths from the supplied identifier. The response envelope changes with that scope.
One post
Returns stored destination snapshots for post_id, most recent first. The window input does not change this read.
One account
Returns snapshots for account_id within the supplied 7d or 30d window, most recent first.
Observed API record
Return shape
Returns a post-scoped or account-scoped envelope containing normalized performance rows and a summary. The rows are the most recent ones, and a metric with no value is absent from its row and named under availability with the reason it has none.
post_idstring- Present on post-scoped reads.
account_id · windowstring- Present on account-scoped reads.
window_limit_daysnumber- How far back this workspace's plan reaches, whatever window was requested.
performancearray- Normalized rows, each tied to one destination publish, most recent first.
performance[].publish_idstring- Destination publish that produced the snapshot.
performance[].platform · captured_at · sourcemetadata- Destination, observation time, and webhook or poll source.
performance[].views · likes · comments · sharesnumber- Required normalized engagement counters. Numeric zero remains zero.
performance[].savesnumber | absent- Normalized saves when evidence exists. Numeric zero remains zero; with no value the key is absent from the row.
performance[].watch_time_s · avg_watch_pct · completion_pct · follower_deltanumber | absent- Normalized watch and audience fields. Numeric zero remains zero; with no value the key is absent from the row.
performance[].change_since_lastobject | optional- Per-field numeric changes when a previous snapshot exists.
performance[].availabilityobject- One entry per absent metric, each carrying that metric's state and the reason it has no value. A metric with a value is not listed here.
truncated · snapshots_total · snapshots_returnedflag · numbers | optional- Present only when the window held more snapshots than limit returned. Absent means the rows are the whole window.
week_over_weekobject | null- Account reads include the latest two completed account-local weeks, per-metric aggregates and deltas, availability, and observed-publish counts for both populations.
eligibilityobject- Post reads can return ineligible with publish_failed.
summarystring- Human-readable summary of returned evidence.
Stop conditions
Agent handoff
both IDs · neither IDCorrect the call
Provide exactly one of post_id or account_id.
eligiblePreserve evidence
Return each value with the observation time on its own row, and keep every absent metric's reason with it.
truncatedSay the answer is partial
Report snapshots_returned of snapshots_total, or raise limit and read again. Never present these rows as the whole window.
ineligible · publish_failedStop measurement
Return the eligibility reason instead of inventing a snapshot.
absent metricKeep it distinct
An absent key is not a zero. Read its reason from availability, and do not promise a reason for every state.