SocialSeal

com.socialseal/mcp · v0.2.2

Measure how findable a brand is in TikTok, Instagram, YouTube and AI search, and what to post next.

MCPremoteno credentialsAnalytics & marketing

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 128 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 67/100

What it does: 128 tools · 55 read, 73 write (incl. delete/pay) · Analytics & marketing

Test call socialseal_search_workspace_notes: failed — tool error: Connect your SocialSeal account to use this action. (899 ms)

How the rating is made

Answers without login: +30
Speed of first answer: +10
Lists tools: +10
Tool descriptions: +15
Parameter descriptions: +2
Read/write annotations: +5
Safe test call: 0
More than 80 tools: -5

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL

https://mcp.socialseal.co/mcp

Tools

128 tools listed at last check

socialseal_get_scheduled_spending Read existing Monitor schedules, their per-run maximum, monthly exposure and standing approval. This does not publish or approve a schedule. Only a human may approve schedule terms and a monthly cap; changes to scope, schedule or price need fresh approval.
socialseal_resume_paid_operation 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_get_paid_operation Read a preserved operation's status, quote, retained result and USD settlement receipt. Polling and retrieving prior results are free. Funding alone is not successful task completion.
socialseal_get_workspace_balance Read workspace prepaid USD funds, active holds, monthly UTC headroom and approval threshold. Subscription credits remain their own allowance and are never converted to a cash balance.
socialseal_start_visibility_check Receive one complete evidence-backed Visibility Check per user for a brand and market. Uses normal login, including consumer email. This is optional: a specific creator, video or export request should use its own action directly. Returns a durable operation; read candidate themes, continue with stor
socialseal_continue_visibility_check Continue the same free check through deep collection using 3–5 candidate theme IDs and verified competitor IDs from its latest snapshot. Preserve the requested brand and market. Select clear matches directly; ask the user only when intent is ambiguous. Never invent theme IDs or snapshot versions.
socialseal_get_visibility_check Retrieve progress, candidate themes or the released complete Visibility Check. Read the same operation after reconnecting; polling costs nothing. Return evidence, scope, freshness and limitations honestly. A report awaiting review is not yet released, and a partial report is not a complete outcome.
socialseal_search_videos Start a bounded video search for a query, platform and region. Uses the workspace's existing analysis billing and canonical admission; may incur provider collection cost. Returns jobId when admitted or a preserved operationId when funding or approval is needed. Read or resume the same paid operation
socialseal_get_video_search Read status, available results or a typed failure for an existing video search. Pass its canonical jobId and workspaceId. Read-only; no collection or charge. Poll this action instead of starting the search again. Search rows describe videos surfaced for selected queries at capture time, not search v
socialseal_collect_account_window Start a one-off TikTok public timeline capture for an explicit publication window [startAt,endAt). No tracker. Uses one monitoring credit for subscriptions or a saved USD quote for prepaid work. Funding or approval returns an operationId to continue after approval. maxProviderRequests includes profi
socialseal_continue_account_window Collect at most one further provider page within the receipt's existing credit and request cap. Pass afterSequence from continuation. Repeating the same sequence cannot invoke another provider request. Completed pages and actual observation times are retained. Running receipts require a read, never
socialseal_get_account_window Free stored evidence read. Page both posts and unresolvedPosts with offset/limit until pagination.hasMore=false. To archive immutable raw provider pages, request each sequence from captureManifest using captureSequence. Preserve null metrics, source IDs, observation times, partial coverage and cost
socialseal_collect_creator_account Collect one bounded Instagram account profile/timeline snapshot for a named profile URL or handle, independent of tracking or search results. Creates a caller/workspace-scoped execution receipt and provider evidence; never creates a tracker. Uses maxCredits=1 for existing subscriptions or a saved pr
socialseal_get_creator_collection Read the status and evidence of one caller/workspace-scoped creator collection receipt. No provider call, charge or new tracker. Running receipts return continuation; complete and failed are terminal. Preserve partial metrics and brand evidence.
socialseal_get_creator_profile Read a supplied Instagram profile URL or handle directly, with account timeline posts (images, carousels and videos), publication dates, captions, available metrics, deterministic average views and engagement rates with formulas/denominators, freshness and coverage, plus accessible workspace brand c
socialseal_get_creator_recent_posts Read a supplied Instagram profile URL or handle directly, with account timeline posts (images, carousels and videos), publication dates, captions, available metrics, deterministic average views and engagement rates with formulas/denominators, freshness and coverage, plus accessible workspace brand c
socialseal_search_workspace_notes Find existing brand facts, constraints and decisions in authorized workspace notes. 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 con
socialseal_get_workspace_note Read an existing note by its returned ID. 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_core_workspace_notes Read core context, building its stored cache from existing notes if absent. No provider collection or model cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not author
socialseal_create_workspace_note 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_update_workspace_note Replace the current workspace note with the supplied content as a new version, mark the previous version superseded and rebuild core context. Prior versions remain stored. Returns the new note and superseded note identifier. No provider collection cost. Changes only the requested workspace state. Ba
socialseal_pin_workspace_note 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_rebuild_core_workspace_notes Rebuild the core context from existing notes; does not collect social content. 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_get_brand_strategy Read the published content Strategy for a Brand (default: the Workspace's primary Brand): offer, wanted and unwanted audiences, frictions, messaging and production rules, angle ledger and decision tests, plus any pending draft. Call before content strategy, ideas, briefs, calendars, captions or inte
socialseal_propose_brand_strategy Save a draft Strategy revision for user review. Pass the complete Strategy and expectedBaseRevisionId (the published revision you read, or null when none exists). Drafts do not affect agents or generation until published. Use it when the user asks to create or change the Strategy, or after they conf
socialseal_publish_brand_strategy Publish a draft Strategy revision so agents and brief generation apply it. Call only after the user has explicitly approved this exact draft in the conversation. Fails with BRAND_STRATEGY_STALE_BASE when the published Strategy changed after the draft was proposed. Changes only the requested workspac
socialseal_list_brands Retrieve existing brand context before asking the user for brand identifiers. Returns canonical brands and workspace roles. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling u
socialseal_create_brand 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 a
socialseal_list_brand_groups Read named sets of existing brands. These are not tracking groups. 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_create_brand_group 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_update_brand_group Update a comparison set's name or description; 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_delete_brand_group 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_add_brand_group_member Add an existing brand to the requested 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_remove_brand_group_member Remove membership in the requested 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_list_brand_aliases Read known attribution aliases for an accessible brand. 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_create_brand_alias Attach a handle, hashtag or keyword attribution alias. A handle alias marks that platform account as brand-owned and requires its platform; it does not monitor the account; no collection cost. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budge
socialseal_set_brand_alias_active Change the active state of one attribution alias; 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_start_google_ai_search Start the specified Google AI queries. May incur provider collection cost under existing admission. Returns a numeric runId; poll socialseal_get_tool_status with kind=google_ai_run and read results after completion. Changes only the requested workspace state. Backend authorization, validation and an
socialseal_list_google_ai_search_runs Read collected Google AI run status and progress, scoped to the requested run or tracking item. 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
socialseal_get_google_ai_search_results 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
socialseal_create_tracking_group Create the requested single-platform tracking group; does not establish populated or fresh evidence. A group with the same name (trimmed, case-insensitive), platform and locale_key is returned instead of a duplicate, with reused_existing=true. Changes only the requested workspace state. Backend auth
socialseal_merge_tracking_groups Merge the requested source groups into the target group: the target keeps the union of their items (a shared item is still collected once) and the source groups are deleted. All groups must use the target's platform; a source group still referenced elsewhere blocks the whole merge without changes. C
socialseal_bulk_delete_tracking_groups Delete the explicitly listed groups; their tracking items stay in the workspace. Reports deleted, missing and blocked group IDs separately. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool
socialseal_add_tracking_group_items Attach existing item IDs, or add search values with Topic assignments. Search adds use canonical Topic resolution; omitted Topics never create an unclassified active search. Returns item-level or typed activation outcomes. Changes only the requested workspace state. Backend authorization, validation
socialseal_remove_tracking_group_item Remove only the requested group membership. 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_tracking_group Update the requested group name, description or refresh schedule; scheduling can affect future 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 add
socialseal_delete_tracking_group 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_refresh_tracking_group Queue collection for the existing group. May incur collection cost. Returns the existing refresh polling contract; no completion or freshness claim before status/evidence confirms it. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and ide
socialseal_get_tracking_group_refresh_status Read the existing group's collection queue state; does not start another refresh. 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 conti
socialseal_list_tracking_groups Show existing authorized tracking groups across their configured platforms. Reads stored configuration without collection, refresh or setup; no new collection cost. Use the returned group ID and workspace for subsequent reads. Groups overlap, so never add up items_count for a tracked total; use soci
socialseal_get_tracking_group Read an existing tracking group's configuration by ID. Reads stored data; does not refresh evidence or create tracking. No new collection cost.
socialseal_get_tracking_group_completeness Compare expected memberships with stored items in the authorized tracking group, including missing/extra items, platform mismatches and optional stored refresh-job status. Omit expected_items to inspect current membership. Reads existing configuration/jobs only; no collection, refresh, mutation or n
socialseal_list_tracking_group_items Read the monitored items in an existing tracking group, paginated by page and limit. Stored membership is not fresh search evidence. No collection or new collection cost; no setup prerequisite.
socialseal_get_tracking_inventory Read the workspace's canonical tracked-item total and breakdown: one item per search in one market on one platform, hashtag or account, counted once however many groups include it, with paused items separate. Use this total whenever you state how many searches, hashtags or accounts are tracked; do n
socialseal_list_tracking_items Read existing tracked items and their actual platform/market scope. Results are paged; for how many items are tracked, use socialseal_get_tracking_inventory. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and
socialseal_get_tracking_item Read one existing tracked search, hashtag or account. 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 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 res
socialseal_list_workspace_topics 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 e
socialseal_track_account Create only the explicitly requested ongoing account commitment. May schedule provider refresh and incur collection cost under existing controls. Use creator reads for a one-off evaluation. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget a
socialseal_track_search_or_hashtag Create the explicitly requested search/hashtag commitment. Active searches require Topic resolution: pass topicDefinitions and topicRefs, or omit them for automatic organisation. Unambiguous single-search automatic results preview and execute together; ambiguous results return TOPIC_INPUT_REQUIRED w
socialseal_preview_search_activation 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 a
socialseal_execute_search_activation 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
socialseal_refresh_tracking_item Request fresh collection for an already monitored item. May incur collection cost; retain the returned job/status information and do not duplicate starts. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain auth
socialseal_resume_tracking_item Resume collection for a paused item. The result's collection field says what will collect it: monitor, prepaid or subscription (collected from the next scheduled run), manual (only on request), or needs_schedule_approval (resumed, but prepaid collection needs a standing approval in Workspace funds b
socialseal_update_tracking_item Update the requested item configuration; scheduling changes can affect future collection cost. is_active: true resumes a paused item (same rules as socialseal_resume_tracking_item); pausing is not supported. Changes only the requested workspace state. Backend authorization, validation and any quote/
socialseal_delete_tracking_item Delete the requested tracking item. This changes ongoing monitoring; it is not needed for account metrics. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not authorize add
socialseal_get_video_evidence Read stored analysis for returned video identifiers. URLs are not accepted for polling; missing or pending evidence does not trigger provider work. Separate observed hooks/shots/transcripts from model interpretations. Photo/carousel analysis uses one-based slideIndex references; it provides no video
socialseal_extract_video_assets Retrieve assets for stored post identifiers. TikTok photo/carousel posts return ordered signed slide images; video posts return video/frame assets. Missing frame extraction or requested analysis may incur processing cost under existing controls. Returns per-item state and source links; poll analysis
socialseal_analyse_public_video Queue analysis of a supplied public TikTok, Instagram or YouTube video URL, or a TikTok photo/carousel post, without creating persistent tracking. Requires an authorized workspace; retrieve accessible workspace context before asking for an ID. May incur collection/analysis cost under existing backen
socialseal_list_source_clips Read existing source clips, rights metadata and available clip analysis; expiring media URLs are not permanent assets. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless
socialseal_prepare_source_clip_upload 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 author
socialseal_finalize_source_clip_upload 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 contr
socialseal_start_search_journey Start bounded keyword expansion for the specified subject/market. May incur collection/analysis cost under existing backend controls. Returns runId; poll socialseal_get_tool_status with kind=journey_run. Creates an execution, not an ongoing tracker. Changes only the requested workspace state. Backen
socialseal_get_search_journey_run Read status and available results of the returned journey run; do not restart it to poll. 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 suppli
socialseal_get_blueprint Read the requested version and source evidence of a saved blueprint; missing evidence remains explicit. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result exp
socialseal_save_blueprint Save supplied evidence-backed blueprint content without provider collection. Do not fabricate evidence citations. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool selection does not author
socialseal_generate_blueprint 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 social
socialseal_get_blueprint_shots Read existing shot panels and source references with expiring signed URLs; no new collection. 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 su
socialseal_refresh_blueprint_shots Regenerate reference panels for the selected blueprint. May incur processing cost under existing controls; this does not assemble a video. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency controls remain authoritative; tool
socialseal_get_brief Read an existing brief version and evidence. Brand/strategy setup is not required to retrieve it. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the result explicitl
socialseal_update_brief 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 ve
socialseal_save_brief Save supplied brief content tied to a real blueprint version; 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_generate_brief 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
socialseal_export_brief 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 un
socialseal_get_brief_readiness Check evidence readiness for creative brief generation or editing. This check does not gate unrelated reads, account metrics or URL analysis. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchro
socialseal_start_brief_run Start the requested topic's brief execution, preserving backend readiness, budget and idempotency. May consume credits. Poll socialseal_get_brief_run with the returned runId; no social publishing or persistent account tracker. Changes only the requested workspace state. Backend authorization, valida
socialseal_get_brief_run Read progress, result and failure evidence for an existing brief 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_retry_brief_run Retry the existing run under backend context-fingerprint and idempotency checks. May consume credits. Poll socialseal_get_brief_run; do not silently force a full rerun. Changes only the requested workspace state. Backend authorization, validation and any quote/approval, budget and idempotency contro
socialseal_get_brief_outcomes Read weekly ranking outcomes only for posts actually linked to the specified brief; this sample is not total account reach. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling u
socialseal_attach_brief_publication 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.
socialseal_list_search_journeys List existing journey identities and optionally their latest runs. 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_search_journey Read a selected existing journey and optionally its latest execution. 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 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 continuat
socialseal_list_keywords Read existing keyword records and their evidence/strategy associations. Each keyword carries demandSignals: evidenceLevel (strong/indicative/untested), the demand signals present, and googleSearchVolume.state (not_collected means never fetched, not zero). Listing keywords does not start searches. Re
socialseal_check_keyword_demand Rank candidate keywords, hooks or titles by demand evidence before choosing a wording. Checks live Google and YouTube autocomplete (free public endpoints; no SocialSeal charge) and reads Google search volume already stored for the workspace. Returns results ranked by evidenceLevel (strong/indicative
socialseal_create_keyword Save the specified keyword and associations; does not create monitoring or collect provider data. 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 w
socialseal_create_keywords Save the specified keyword batch; does not create monitoring or collect provider data. 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_keyword Update the requested keyword record and associations; 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_update_keywords Apply the requested patch to the selected keyword IDs; 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_keyword 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_sync_keywords_from_tracking Copy existing tracked keyword associations into the keyword registry; does not run 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 additi
socialseal_list_personas Read saved workspace personas. Personas are supplied strategy records, not inferred private audience demographics. Reads stored evidence/configuration; no provider collection or collection charge. Preserve returned timestamps, coverage, missing evidence and errors. Synchronous; no polling unless the
socialseal_create_persona Save the user's evidence-backed strategy persona; never fabricate private audience demographics. 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
socialseal_update_persona Apply requested changes to a saved 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_retire_persona Mark the requested strategy persona inactive; 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 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_list_workspaces 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_get_current_workspace 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_tool_status 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
socialseal_explore_preview_start 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 returne
socialseal_explore_start Start audience-demand research for the supplied anchor, market and language. Creates a research lineage and queues a collection run, which may consume credits and provider costs. First call socialseal_explore_preview_start; use its planFingerprint as previewFingerprint with the same scope, explicit
socialseal_explore_list Read the canonical workspace Explore overview, including lineages, latest snapshots, recommendations, capabilities, and blocking reasons. Each snapshot carries signalRanking: its terms ordered by observed demand signals with an evidenceLevel (strong/indicative/untested), usable for prioritising even
socialseal_explore_get Read one canonical Explore lineage, snapshot, run, selection, or compatible snapshot comparison. The response is returned without collapsing evidence, unavailable sources, or partial states. A snapshot's signalRanking orders its terms by observed demand components (Google volume, autocomplete salien
socialseal_explore_refresh Queue a new demand-research run for an existing Explore lineage. May collect new provider evidence and consume credits. Requires the workspace, lineage and retry key. Returns run identifiers and execution state. Reuse the same idempotencyKey; supply confirmedScopeFingerprint only after requested sco
socialseal_explore_select Persist an exact, user-confirmed Explore selection for a stated destination and intended use. No additional terms are inferred or added.
socialseal_explore_correct_interpretation Apply one canonical interpretation correction with stable retry identity and the exact labels and memberships supplied by the caller.
socialseal_explore_preview_activation Request the server-owned activation plan for an immutable Explore selection without activating it.
socialseal_explore_activate_searches Activate the selected Explore searches as Monitor tracking using the supplied preview plan and complete bindings. Creates, extends or reuses Monitor scope, reconciles workspace defaults and may queue baseline collection under existing credit controls. Returns activation status, identifiers and block
socialseal_explore_handoff Prepare a server-issued Explore continuation for the selected destination. A handoff is not action acceptance and carries no client-inferred payload.
socialseal_explore_create_deliverable 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 t
socialseal_export_tracking_data 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
socialseal_export_report 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_
socialseal_read_export_chunk Read rows of a previously generated SocialSeal export artifact in-session, paginated as JSON. Use this when the export tool returns a download_url you cannot fetch (e.g. sandbox egress limits or web_fetch cannot render a CSV attachment). Pass the short download token (the `t` query param from downlo
socialseal_discover_concepts 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_capabilities Look up released capability metadata. Optional reference; this does not gate execution or authorize work.
socialseal_list_skills 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
socialseal_read_skill Read the full instructions for one SocialSeal skill. Provide skill (and optional file, defaulting to SKILL.md) to read within skills/<skill>/, or provide path to read a repo-relative file under skills/, references/, docs/, templates/, or examples/.
socialseal_get_skills_archive 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.

Badge

Markdown for your README

[![Connect-MCP](https://clawy.uk/mcp/badge/com.socialseal/mcp.svg)](https://clawy.uk/mcp/s/com.socialseal/mcp)

Repository · Website