Configured tool · read-only

`get_performance`

Read normalized measurements for one post or one connected account.

read-onlynon-destructiveclosed-world

Human and agent roles

Configured boundary

Configured workspace

Provide exactly one scope identifier. Preserve every number, null, availability state, reason, and observation time.

This reference describes a connection made with @postdom/mcp@0.3.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.

FieldTypeContract

post_idOptional

string

Exclusive with account_id

Reads all stored destination snapshots for one post.

account_idOptional

string

Exclusive with post_id

Reads snapshots for one connected account.

windowOptional

7d | 30d

Defaults to 7d

Applies only to account reads. It does not change post-scoped reads.

Synthetic values

Example call

Identifiers and values are examples. They do not represent a connected workspace or accepted media source.

EXAMPLE CALL · CONFIGURED TOOL SCHEMA

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.

POST

One post

Returns all stored destination snapshots for post_id. The window input does not change this read.

ACCOUNT

One account

Returns snapshots for account_id within the supplied 7d or 30d window.

Observed API record

Return shape

Returns a post-scoped or account-scoped envelope containing normalized performance rows and a summary.

post_idstring: Present on post-scoped reads.
account_id · windowstring: Present on account-scoped reads.
performancearray: Normalized rows, each tied to one destination publish.
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 | null: Normalized saves when evidence exists. Numeric zero remains zero.
performance[].watch_time_s · avg_watch_pct · completion_pct · follower_deltanumber | null: Nullable normalized watch and audience fields. Numeric zero remains zero.
performance[].change_since_lastobject | optional: Per-field numeric changes when a previous snapshot exists.
performance[].availabilityobject: Per-field state, verification time, evidence category, and reason.
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 ID

Correct the call

Provide exactly one of post_id or account_id.

eligible

Preserve evidence

Return values with their availability metadata and observation time.

ineligible · publish_failed

Stop measurement

Return the eligibility reason instead of inventing a snapshot.

null

Keep it distinct

Never convert null to zero or promise a reason for every availability state.