SocialSeal

Continue the same requested work after funding or human approval. Rechecks live workspace permission, the bound connector grant, the current quote and spending limits. Never submits a new arbitrary task or changes its inputs. Repeating this action cannot charge twice.

socialseal_resume_paid_operation

Apply one canonical interpretation correction with stable retry identity and the exact labels and memberships supplied by the caller.

socialseal_explore_correct_interpretation

Create a named brand comparison set; no tracking or collection cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_create_brand_group

Create the explicitly requested brand identity and workspace role; no account monitoring or collection cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_create_brand

Create the requested single-platform tracking group; does not establish populated or fresh evidence. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_create_tracking_group

Save a requested fact, preference, decision or constraint. No provider collection cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_create_workspace_note

Create a shareable JSON report from an existing Explore selection, including its saved search terms, interpretation, evidence and limitations. Saves an immutable report and creates an external share link valid for 30 days. Requires an explicit workspace, selection and idempotencyKey. Retries reuse the report but issue a fresh share link.

socialseal_explore_create_deliverable

Persist an exact, user-confirmed Explore selection for a stated destination and intended use. No additional terms are inferred or added.

socialseal_explore_select

Delete the requested comparison set; no provider collection. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_delete_brand_group

Delete only the requested keyword record. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_delete_keyword

Delete the explicitly requested group; does not silently replace it or recollect evidence. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_delete_tracking_group

Look up released capability metadata. Optional reference; this does not gate execution or authorize work.

socialseal_discover_capabilities

Discover the canonical SocialSeal concept registry: metric concepts (discoverability, visibility, share of voice, reach, ranking, sentiment) and the domain glossary, with definitions, distinctions, required dimensions, evidence requirements, and input-only aliases.

socialseal_discover_concepts

Save the requested creator-brief edits as a new version without modifying or deleting prior versions. Unspecified fields, evidence lineage and pinned context are preserved; supplied arrays replace that field in the new version (null arrays clear it). Supply briefId or opportunityKey. A stale base version is rejected. Reuse editId on retry; an unchanged retry can return NO_CHANGES before replaying the original result, so read the saved brief to verify its version. Without editId, retries may create additional versions. A successful write returns the saved brief, version and deduplication status. No collection cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_update_brief

Commit Topics, assignments and search activations atomically for a previewed plan. Requires planFingerprint and idempotencyKey. Duplicate retries return the original created or reused result. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_execute_search_activation

Export a SocialSeal report. Use reportType search_results_enriched, format csv and payload.groupIds for ranked search results; reuse the workspace from the group lookup. Poll the returned export ID while pending, then fetch download_url or page socialseal_read_export_chunk with read_token until has_more is false. Report partial coverage if retrieval stops early. Search rows describe videos surfaced for selected queries at capture time, not search volume or total market demand. Region is the collection market, not verified viewer geography. Views/likes/saves are video engagement snapshots, not engagement attributable to that query or gains during the export window. State query/platform/market/date scope and coverage; deduplicate videos before aggregating across queries. Define rate denominators and preserve missing values as unknown. Inspect relevant video evidence before recommending a creative treatment.

socialseal_export_report

Export legacy time-window tracking data for the authenticated SocialSeal user. Always reuse the workspaceId from the lookup that returned the selected group or tracking item; numeric IDs are not sufficient workspace context. Fulfilled as an export artifact: returns download_url plus a read_token for in-session paginated reads with socialseal_read_export_chunk when the URL cannot be fetched. For ranked discoverability, use socialseal_export_report with reportType search_results_enriched.

socialseal_export_tracking_data

Export the requested brief version for handoff. No new provider collection; preserve returned artifact and evidence links. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result explicitly supplies continuation.

socialseal_export_brief

Finalize the requested upload only after bytes are uploaded and rights are attested. May trigger existing clip-analysis processing; preserve provider/admission failures. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_finalize_source_clip_upload

Find a target by exact type, value, platform and region, including inactive matches. Does not create tracking. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result explicitly supplies continuation.

socialseal_find_tracking_item

Generate a blueprint for the supplied scope or manual videos. May consume analysis credits; use previewOnly to inspect selection and retain existing admission/readiness controls. Read the returned opportunity/version with socialseal_get_blueprint; only a usable generated blueprint should feed socialseal_generate_brief. Draft means pending evidence and missing_data requires inspecting the stated gap. This is reference synthesis, not measured proof of creative effectiveness or a finished video. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_generate_blueprint

Create a video, creator, UGC or editor brief with hooks and shot direction. Use an existing blueprintId/version or a topic, competitor or tracking_group scope; retrievalPrompt refines scoped retrieval and cannot accompany blueprintId/version. Carry approved audience/product facts and constraints in brandContext; do not assume project documents are loaded. Read existing work with socialseal_get_brief, edit with socialseal_update_brief, and export with socialseal_export_brief before formatting as Word/PDF. May consume analysis credits under existing controls. Generated status does not establish factual accuracy, executable timing or creative quality; inspect the returned evidence and missing-data states. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_generate_brief

Return download URLs for the full SocialSeal agent-skills repository (zip/tarball) plus the install command, so the agent or user can download every skill at once.

socialseal_get_skills_archive

Read-only polling for a known SocialSeal async run, export, or group refresh. UUID auto ids are journey runs; numeric auto ids are Google AI runs. Both are workspace-scoped, as are google_ai_run, journey_run, explore_run, and video_analysis. Pass the workspaceId from the lookup that returned the run. MCP-host errors such as "No approval received" occur before SocialSeal executes this tool; never describe them as SocialSeal billing, workspace approval, or job-status errors.

socialseal_get_tool_status

Read one canonical Explore lineage, snapshot, run, selection, or compatible snapshot comparison. The response is returned without collapsing evidence, unavailable sources, or partial states.

socialseal_explore_get

Get the current workspace before a workspace-scoped action when the user has not named one. Hosted MCP resolves the live active/default workspace, falling back to the sole accessible workspace; local MCP returns the workspace selected in environment/configuration.

socialseal_get_current_workspace

Read diagnostics for the existing journey scope without starting another run. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result explicitly supplies continuation.

socialseal_diagnose_search_journeys

Attach an externally published video that this saved Brief produced. Requires the exact Brief ID, not a reference video. Reuses canonical video identity; duplicate conflicts preserve the original binding and baseline. URL resolution may incur collection cost under existing backend billing controls. Omitted trackingItemIds explicitly selects all workspace tracking; provide target IDs and region for scoped evidence. This does not publish content or prove causal uplift. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_attach_brief_publication

Read the canonical workspace Explore overview, including lineages, latest snapshots, recommendations, capabilities, and blocking reasons.

socialseal_explore_list

Discover optional task-specific SocialSeal guidance after identifying the requested work. For a content calendar or posting schedule, select socialseal-social-plan-builder; for video/editor/UGC briefs, select socialseal-creator-briefing. Loading guidance does not execute generation tools. Skills are not prerequisites for basic operations. Returns each skill's name and frontmatter description (so you can route without reading every SKILL.md), file paths, shared references, the install command, and the archive download info.

socialseal_list_skills

List workspaces visible to the authenticated SocialSeal user. List order and owner role do not identify the default; use defaultWorkspaceId/isDefaultWorkspace, or call socialseal_get_current_workspace before a write when the user did not name a workspace.

socialseal_list_workspaces

Read active Topics with stable IDs, names and descriptions before assigning searches. No collection cost. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result explicitly supplies continuation.

socialseal_list_workspace_topics

Change whether the specified note is included in core context. No provider collection cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_pin_workspace_note

Create the requested source clip upload and return signed upload fields. Requires a separate byte upload and finalize action; no assembled-video output. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_prepare_source_clip_upload

Prepare a server-issued Explore continuation for the selected destination. A handoff is not action acceptance and carries no client-inferred payload.

socialseal_explore_handoff

Request the server-owned activation plan for an immutable Explore selection without activating it.

socialseal_explore_preview_activation

Read the server-owned acquisition plan for an authorized workspace, anchor, market and language. Returns planFingerprint, estimated credits, capacity, source availability, blocking reasons and confirmationRequired. Does not create a lineage, queue a run or collect provider evidence. Pass the returned planFingerprint as previewFingerprint to socialseal_explore_start with the same scope. Ordinary plans need no additional user confirmation; request scope confirmation only when confirmationRequired is true.

socialseal_explore_preview_start

Return the exact Topics to create or reuse, per-search assignments, conflicts, credits and planFingerprint without activating. Use execute_search_activation with that fingerprint to commit. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_preview_search_activation

Reactivate the requested existing strategy persona; no provider collection. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize additional work.

socialseal_reactivate_persona

Read stored Google AI answers and citations, preserving the actual query and historical capture scope. Paginate offset/limit. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result explicitly supplies continuation.

socialseal_get_google_ai_search_results