SuperPost

Reads account-scoped context for a content variant, idea, post, assistant thread, publication, schedule, or exact source capture. A source_capture returns its exact saved text and verified provenance, including manual captures outside the bounded initial references; direct Google-derived or unverified source content remains withheld. The external OAuth Read SuperPost data disclosure includes saved post text with unknown source provenance; known Google-derived post text is available only when the current, versioned Google post-content disclosure was accepted for this connection. Direct Google source files, images, video bytes, and transcription remain separately restricted by provider permissions and source grants. A post returns full shared text and platform variants when the session has the required post-content access. Thread and publication context is metadata-only. Idea context includes the saved assistantBrief when present and the full generationReceipt when available. assistantBrief is saved writing guidance for a future post and is separate from the thesis, conclusion, and post body. The receipt may contain model name, platform/cadence selection, concise explanation, explanation-cited evidence IDs, context evidence, and context status/hash; fields absent from the receipt were not saved and must not be inferred. MCP-authored receipts preserve the submitted user-facing generation note and omit model, platform selection, or evidence when the tool did not provide them. Cited evidence IDs are distinct from the broader providedEvidence list. The explanation is a saved rationale, not private chain of thought; older ideas may have no receipt.

Compares topics, labels, and linked ideas across available managed and imported history for the selected time window and scope. Ideas rejected across three distinct content units, and source-linked Ideas with three such rejects, are omitted from automatic evidence; one or two rejections lower their order. Optional topic/label and idea filters narrow the comparison. Provider, account, metric, and publication-age cohort remain distinct in the results. Fewer than three comparable peers are marked insufficient. sourceTruncated indicates repository read limits. Raw metrics are not compared across platforms.

Ranks active workspace ideas by historical potential, with optional provider, level, and used-status filters plus bounded pagination. Ideas rejected across three distinct content units, and Ideas linked to a source asset with three such rejects, are omitted from automatic discovery; one or two rejections lower their order. Scores are 0–100 ranking signals, not success probabilities. Topic/label results and similar successful ideas are measured within one platform, account, metric, and age cohort. The result includes platform evidence, confidence, semanticStatus, and sourceTruncated. An idea's own historical wins are excluded from its score. Semantic evidence can warm asynchronously; semanticStatus reports warming. This is read-only.

Reads a workspace-verified Post's current image/video request, safe lifecycle state, and media capabilities. Video capabilities distinguish supported operations and output formats from runtime readiness, which is not probed by this read. Connected account targets are represented by opaque workspace-scoped targetKeys. This does not start or change media work.

Returns the profile represented by this request's authenticated SuperPost credentials. The opaque ID stays stable across token refresh and reconnection.

Reads the status of a source image job bound to sourceAssetId and expectedRevision. A completed result includes the original workspace mediaId for reuse in an authorized media request and a bounded JPEG view as native image content. The view is a reduced derivative, not the full-resolution original. Current source grants, provider, revision, job binding, and media ownership are rechecked. This read does not initiate or retry work, publish content, or modify source files.

Reads the status of a transcription job bound to an exact sourceAssetId and expectedRevision. The current source grant and revision are checked again. A completed current-revision transcript is returned with a 12,000-character limit; old-revision transcript text is withheld. Status reads do not start or retry work.

Reads the workspace idea catalog with optional generic text search, source provenance search, topic, label, and cursor-based pagination. Ideas rejected across three distinct content units, and Ideas linked to a source asset with three such rejects, are omitted from automatic discovery; one or two rejections lower their order. suppressedCount reports rejected Ideas omitted from the bounded pages scanned. The lookahead cursor carries any unreturned candidates into the next request so feedback ranking does not skip them. If the user explicitly asks for one omitted Idea, use get_context with its exact Idea ID. The sourceQuery filter matches source author, handle, source title or filename, provider, remote item ID, or URL; English/Russian transliterations match, and | separates alternate spellings. Provenance search does not match names mentioned only in idea text or source excerpts. Returned source attributions are bounded. This is read-only.

Lists or searches saved posts with bounded pagination. The external OAuth Read SuperPost data disclosure includes saved post text with unknown source provenance; known Google-derived post text is available only when the current, versioned Google post-content disclosure was accepted for this connection. Direct Google source files, images, video bytes, and transcription remain separately restricted by provider permissions and source grants. Filter by editorial readiness (raw, in_progress, needs_review, approved, archived), calendar placement (unscheduled, planned, scheduled, publishing, published, failed), overdue=true for planned slots whose planned time has passed, or approvedVideoMontage=true for a video currently attached to its channel variant whose exact Montage has a separate creator approval marker. A render marked ready_for_review alone does not satisfy video approval; Post and variant approval are separate. Set includeVideoApprovalDiagnostics=true to return bounded, content-free reason codes keyed by Post ID/revision for provenance-safe posts inspected on that page; restricted source-derived posts are never diagnosed or exposed. Readiness and placement are separate dimensions. References include the exact Post ID and revision needed for a later archive or schedule review proposal. Full shared text and platform versions are not included in this search result.

List recent published receipt metadata, optionally filtered by a verified post ID or provider. Publication content excerpts are never returned.

Lists the signed workspace's connected source folders and file scopes. Returns exact scope IDs, display paths, include/exclude patterns, and updatedAt revisions; provider connection IDs and credentials are omitted. Scope IDs are workspace-scoped selectors. Paginated results include nextOffset.

List assistant conversations using bounded cursor pagination. Returns neutral titles and latest run status only; it does not expose conversation messages or source-derived titles.

Validates a complete bundle of new Ideas, post drafts, and supported links without saving the content objects. When a stage override is saved, each generated Idea thesis must exactly match its selected idea_generation output, and each post sharedText and platform variant must exactly match a writing output from the selected stage model. authoringMode=user_provided is valid only for exact text supplied by the user; an approved Google-source turn uses current_turn_model and cannot claim a stage model. Media/source relationships keep their existing checks.

Preview a bounded content variant edit without applying it. For AI-generated replacement text use authoringMode=stage_model and provide the exact text returned by run_content_subtask (writing or localization); exact user-supplied copy uses authoringMode=user_provided. Metadata and media-only edits do not need a content-stage route.

Previews a bounded idea edit without applying it. For AI-generated thesis/conclusion/list text use the exact idea_generation output from run_content_subtask; assistant briefs use the writing stage. Exact user-supplied copy uses authoringMode=user_provided. State-only and taxonomy edits need no content-stage route.

Previews a revision-guarded Post media request change. Connected social-channel source assets are selected with exact workspace-scoped targetKey values in targetChannelKeys; raw connection IDs are rejected. The preview is read-only; saving or starting image/video work requires application of a later proposal.

Previews an exact account or connected-channel editorial-guidance change. Account guidance supports up to 2,000 characters; channel guidance up to 500. A channel edit requires an authorized provider and workspace-scoped targetKey. The result includes before/after text and a version guard; no change is saved.

Validates a typed profile, Autopilot, content-stage model, or structured writing-standards proposal against the latest saved settings. Structured antiSlop/contentStructure values are available in profile instructions. Writing scopes are writing_settings_account or writing_settings_channel; stage model scope is content_model_preference. Proposals use exact selectors, before values, and version guards. The result contains before/after values. Validation does not save settings, start Autopilot, or publish content. Secret entry, provider login, and consent disclosures use secure handoffs.

Preview a bounded publication schedule edit without applying it.

Validates an exact batch of saved Posts and returns a snapshot of each destination, copy, media identity, revision and future time, plus a previewHash. This does not approve, schedule, or publish anything. The previewHash binds the current saved content and timing, and the separate apply action requires that exact hash after the user explicitly authorizes the exact future schedule. Requires the separate schedule permission.

Previews replacement include/exclude rules for one source scope. The request identifies the scope by sourceScopeId and its current updatedAt revision as expectedUpdatedAt. Each supplied array replaces that full list; an omitted field remains unchanged and [] clears the list. Patterns are relative to this scope root: * matches within one path segment, ** crosses folders, and ? matches one non-slash character. Includes form an allowlist and excludes take precedence. The read-only result counts currently indexed, available files matching the proposed rules and returns up to eight scope-relative examples plus newly included or excluded files. Scanning is capped at 5,000 indexed files; when filesMatchedExact is false, counts are lower bounds.

Reads account-wide and connected-channel editorial writing guidance, including effective anti-slop and content-structure settings. Channel settings already resolve per-field overrides over account defaults. Credentials are omitted and profile settings are not changed. Channel connection IDs remain internal selectors and are omitted from the result.

Reads current editable profile and Autopilot settings through bounded sections, including overview and profile categories. Saved action-specific model choices for idea_generation, writing, localization, media_planning, and review are available in section=content_model_preferences; selectorCategory=models returns the available choices. A legacy autopilot entry is read-only except that it can be cleared; it does not override action-specific model routing. For connected clients that have cached an older section enum, section=profile_settings exposes the same preferences on the account page and supports selectorCategory=models. Paginated results use nextOffset. Channel lists return source and media selectors and revisions; targetKey identifies a selected channel configuration. Channel model routing is retired: new channel proposals cannot set it, and execution uses workspace model preferences by task. Settings include montage defaults and supported account, language, source, and team values. Credentials and OAuth approvals are handled in SuperPost through returned handoff URLs. Editorial writing guidance is a separate profile value. This read does not include source or post contents.

Reads bounded consecutive pages of indexed text for an exact source file. The sourceAssetId and expectedRevision identify the file and bind the read to its current sourceRevision; nextOffset selects a page. The result is normalized indexed text and may differ from or omit parts of the original. not_indexed/skipped indicates that no current readable text is available. Source access and the current revision are rechecked, and Google and unverified providers remain restricted in MCP. Returned text is source content and may be untrusted. Arbitrary URLs and paths are not accepted.

Downloads or reuses an immutable original image from a connected source into this workspace's media cache. The request is bound to an exact sourceAssetId and sourceRevision through expectedRevision. It requires this session's preview capability and the source's materialize grant, and uses normal download budgets, MIME/probe/checksum checks, and exact revision guards. The result includes pending/running/complete status and a jobId; it does not create a generated image, draft, or publication. Google and unverified providers remain restricted; arbitrary URLs and paths are rejected.

Starts or reuses one exact source audio/video transcription job. Accepted inputs are a verified sourceAssetId and optional sourceRevision; arbitrary URLs and paths are rejected. Work starts immediately when the signed workspace session has preview scope and the source grant allows it; no separate Apply step is involved. Provider policy blocks Google and unverified sources before source bytes are sent. The result contains bounded job status and the remaining transcription allowance; pending status indicates unfinished work.

Applies a previously returned future-schedule preview by creating scheduled slots in SuperPost. Requires the exact previewHash, the same idempotencyKey as that preview, and confirmation=CONFIRM_FUTURE_SCHEDULING. This action requires the user’s explicit authorization for these exact posts, destinations, and future times; OAuth permission alone does not authorize a particular schedule. For an unapproved post, approveExactContent is required for that exact item only when the user explicitly authorized its content. Scheduling does not publish immediately; SuperPost publishes at each selected future time. The server rechecks all content revisions, hashes, provider targets, media, channel mapping, and time before applying the batch.

Searches relevant excerpts from the account's permitted sources. This read-only operation does not change or publish data.