Insights
Reference for the 4 Insights MCP tools: top_pitches, pitch_to_story_trace, stories_ready_to_push, pitch_review_digest.
top_pitches
The top-ranked pitches created within the last withinHours hours — the newsroom's "what just came in" view in one call. Ranking is the same momentum blend the dashboard uses (score, the event cluster's corroborating-source count, and recency), so these are the top-ranked pitches, not simply the highest-scoring ones. The window applies to when the pitch was generated, not to the date of the news event it describes.
read-only · idempotent · closed-world
limitinteger— How many pitches to return (1–100, default 3)withinHoursinteger— Only consider pitches created within this many hours (1–720, default 1)newsdeskIdstring— Restrict the ranking to pitches for this newsdesk
pitch_to_story_trace
Follow a pitch to the story it produced: returns { pitch, story }, where story is the full story detail (including enrichment status and NRCS push history) when the pitch has been approved, and null when it has not. Answers "what happened to the pitch I approved yesterday" in one call. Requires both pitch:read and story:read; a principal holding only pitch:read gets an error rather than a partial trace.
read-only · idempotent · closed-world
pitchIdstring(required) — Pitch identifier
stories_ready_to_push
Enriched stories that have never been pushed to an NRCS — the "what is ready to send" queue that feeds push_story_to_nrcs. Only stories that originated as pitches are offered; a story minted from the NRCS is never listed, since it already lives there. Scans enriched stories newest-first and keeps the ones with no push history at all (a story already pushed to one NRCS connection is excluded, even if another connection has not received it). Returns { items, truncated }: items are the story rows in that order, not the full detail — call get_story for one. truncated: true means the scan hit its bound of 500 enriched rows with more remaining, so items may be a partial queue rather than empty-because-done. Requires story:read.
read-only · idempotent · closed-world
limitinteger— How many ready stories to return (1–100, default 10)
pitch_review_digest
How much unreviewed work is waiting, broken down two ways: { byNewsdesk, byTopic, scanned, truncated, byTopicCapped }. byNewsdesk buckets carry newsdeskName alongside newsdeskId, counted by scanning pitches with status "new" and bounded — truncated: true means the backlog is larger than the scan, so byNewsdesk and scanned describe only the first 500 pitches rather than the whole queue. byTopic is computed server-side over the entire queue and is unaffected by truncated; byTopicCapped: true means only the highest-count topics are listed. Both breakdowns are ordered by count, descending. Takes no arguments. Requires pitch:read.
read-only · idempotent · closed-world
No input parameters.