# MCP preview tools

> Exact tool names, account roles, scopes, and implemented behavior in the unreleased CreatorsJet MCP preview.
>
> Canonical URL: https://docs.creatorsjet.com/mcp/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`.

## Creator and social tools

| 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.