MCP tools
Complete tool and permission list for technical setup.
Looking for the easy version?
You do not need to use these tool names in an AI assistant. Start with the quick starts and use plain language instead.
This page is for people configuring a technical connection. It lists every available tool and the permission needed to use it.
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.
Creator and social tools
| Tool | Role | Scope | Behavior |
|---|---|---|---|
media_kit_list | Creator or Agency | media_kits:read | Lists visible media kits with opaque pagination. Agencies can filter by a roster creator_id. |
media_kit_ensure | Creator | media_kits:write | Returns the latest personal media kit or creates one link-only default kit. |
social_list | Creator | profile:read | Lists the authenticated creator's connected social accounts without OAuth credentials. |
social_list | Agency | roster:read | Lists connected social accounts for a selected creator in the agency roster. |
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. social_list supports cursor pagination and an optional platform filter. 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 tools support link, title, and text blocks. They do 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 tools do 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 is available through MCP only. There is no sponsorship endpoint in Public API V1.