MCP preview tools

These tools exist in the backend preview but are not yet a generally available public contract.

Agency roster tools

Tool	Scope	Behavior
`roster_validate_import`	`roster:read`	Validates 1–500 normalized creator rows and creates a 30-minute preview when every row is valid.
`roster_commit_import`	`roster:write`	Consumes an approved preview and queues the existing creator-import workflow. Reusing the preview returns the same import.
`roster_get_import_status`	`roster:read`	Returns queue status, progress, created creator and media-kit IDs, and row failures.
`roster_add_creator`	`roster:write`	Adds or links one creator by normalized social identity and ensures the agency media kit exists.

The MCP client parses a spreadsheet into normalized JSON rows before calling roster_validate_import; the tool does not receive a raw spreadsheet file. An agent must show the valid preview and its capacity impact before calling roster_commit_import.

Tool	Role	Scope	Behavior
`media_kit_ensure`	Creator	`media_kits:write`	Returns the latest personal media kit or creates one link-only default kit.
`social_add`	Creator	`media_kits:write`	Adds a social identity to the authenticated creator and synchronizes the personal default kit.
`social_add`	Agency	`roster:write`	Adds a social identity to a selected creator in the agency roster and synchronizes the agency default kit.
`social_remove`	Creator	`media_kits:write`	Removes a selected social identity from the creator and associated personal kits.
`social_remove`	Agency	`roster:write`	Removes a selected social identity from an agency roster creator and associated agency kits.

Agency social calls require creator_id. Creator calls infer the creator from OAuth. Supported social platform values are instagram, tiktok, youtube, facebook, linkedin, twitter, x, twitch, snapchat, and threads.

social_remove is marked destructive. The agent must identify the matching social account and obtain explicit confirmation before calling it.

Link-in-bio tools

Tool	Role	Scope	Behavior
`link_in_bio_get`	Creator	`link_in_bio:read`	Returns the creator's page, social links, and supported blocks.
`link_in_bio_create`	Creator	`link_in_bio:write`	Creates the creator's single page with a public slug and supported content.
`link_in_bio_update`	Creator	`link_in_bio:write`	Updates page copy, social links, or existing and new supported blocks.

The preview supports link, title, and text blocks. It does not delete blocks, upload image or video content, configure custom domains, or expose the complete visual designer. Agents should call link_in_bio_get before deciding whether to create or update.

Pitch-deck tools

Tool	Role	Scope	Behavior
`deck_list`	Agency	`decks:read`	Lists agency-owned decks with opaque pagination.
`deck_get`	Agency	`decks:read`	Returns one owned deck and its selected creator IDs.
`deck_create`	Agency	`decks:write`	Creates a deck from creators already in the agency roster.
`deck_update`	Agency	`decks:write`	Updates selected creators, copy, supported branding fields, slug, or access settings.

Password input is write-only. The preview does not upload deck images, delete decks, or add creators to the roster implicitly. Agents should list or retrieve the deck before updating it.

Campaign tools

Tool	Role	Scope	Behavior
`campaign_list`	Creator or agency	`campaigns:read`	Lists owned campaigns and optionally filters by status.
`campaign_get`	Creator or agency	`campaigns:read`	Returns one owned campaign and its supported settings.
`campaign_create`	Creator or agency	`campaigns:write`	Creates an owned campaign and applies the existing active-campaign allowance.
`campaign_update`	Creator or agency	`campaigns:write`	Updates metadata, dates, tracking cadence or state, CPM values, or EMV override.

New campaigns default to on_request tracking. Automatic tracking requires a future end date. The tools do not manage participants, content, public-report settings, refresh execution, lifecycle actions, or deletion.

Analytics and sponsorship tools

Tool	Role	Scope	Behavior
`analytics_get_views`	Creator or agency	`analytics:read`	Returns page views and unique visitors for one owned resource or an owned-resource aggregate.
`sponsorship_find_matches`	Creator	`sponsorships:read`	Returns evidence-backed matches for an eligible Sponsorship Intelligence account.

Analytics resource types are media_kit, link_in_bio, roster, deck, and campaign. Link-in-bio analytics are creator-only; roster and deck analytics are agency-only. Campaign analytics measure public campaign-report visits, not social content views.

Sponsorship discovery exists only in the MCP preview. There is no sponsorship endpoint in Public API V1.