# Tool reference

> CreatorsJet MCP tools, account roles, permissions, and limits.
>
> Canonical URL: https://docs.creatorsjet.com/mcp/tools

Your assistant chooses tools from your request. This page is for people checking the exact tool names and permissions. For examples, start with [media kits](/mcp/media-kits), [link in bio](/mcp/link-in-bio), or [example requests](/mcp/quick-starts).

The tool list shows the full catalog for creators and agencies; each tool's role column says who can call it, and a call outside your role or approved scopes is refused. Existing owned content is readable on every active account; writes and Find sponsors contact tools check plan eligibility. If a client requests no scopes, it receives standard read scopes by default, including `deals:read`. Deal requests contain brand contact details. Call `mcp_get_access` with an optional `tool_name` to see that tool's required scope and whether this connection can use it.

Successful tools return the same compact JSON in their text result and structured result, so clients that cannot read structured MCP output still receive lists, templates, analytics, and IDs. Errors include a code, message, retryability flag, and safe details when available.

## Connection access

| Tool             | Role            | Scope                           | Action                                                                                                                         |
| ---------------- | --------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `mcp_get_access` | Creator, agency | `profile:read` or `roster:read` | Check this connection's scopes, available tools, and write-plan eligibility; optionally name a tool for exact access guidance. |

## Media kits

| Tool                              | Role            | Scope              | Action                                                                                                                                     |
| --------------------------------- | --------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `media_kit_list`                  | Creator, agency | `media_kits:read`  | List accessible kits; agencies can filter by roster creator.                                                                               |
| `media_kit_get`                   | Creator, agency | `media_kits:read`  | Read one owned kit's content, sharing settings, and safe social performance.                                                               |
| `media_kit_create`                | Creator         | `media_kits:write` | Create a new kit with initial content and an optional listed template, subject to the kit allowance.                                       |
| `media_kit_list_templates`        | Creator, agency | `media_kits:read`  | List 54 design presets with descriptions and cover previews.                                                                               |
| `media_kit_ensure`                | Creator         | `media_kits:write` | Return an existing personal kit or create a default one.                                                                                   |
| `media_kit_update`                | Creator, agency | `media_kits:write` | Edit supported copy, contact, layout, font, and color fields.                                                                              |
| `media_kit_apply_template`        | Creator, agency | `media_kits:write` | Apply a listed cover and accent preset; return its ID and resulting design fields without changing content.                                |
| `media_kit_update_content`        | Creator, agency | `media_kits:write` | Replace supplied rates, partners, case studies, videos, or statistics visibility; change link/private visibility.                          |
| `media_kit_upsert_item`           | Creator, agency | `media_kits:write` | Add or edit one rate, partner, case study, or portfolio video by stable ID. Rates accept `pricing_mode`: `fixed`, `on_request`, or `free`. |
| `media_kit_remove_item`           | Creator, agency | `media_kits:write` | Permanently remove one selected item (destructive; the assistant confirms with you first).                                                 |
| `media_kit_set_social_visibility` | Creator, agency | `media_kits:write` | Choose which metrics are hidden for one attached social account.                                                                           |
| `media_kit_set_sharing`           | Creator, agency | `media_kits:write` | Switch between link-only and private visibility.                                                                                           |
| `media_kit_duplicate`             | Creator         | `media_kits:write` | Create a copy with a new slug, subject to the kit allowance.                                                                               |

Use `media_kit_list` and `media_kit_get` to identify a kit before editing it. The [media-kit guide](/mcp/media-kits) lists the fields handled in MCP and the changes that still need the web editor.

## Deal requests

| Tool                | Role            | Scope        | Action                                                                                                                         |
| ------------------- | --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `deal_request_list` | Creator, agency | `deals:read` | List owned incoming requests by creation time, newest first, with cursor pagination and an optional owned media-kit ID filter. |
| `deal_request_get`  | Creator, agency | `deals:read` | Read one owned incoming request by ID.                                                                                         |

New media-kit requests record their source kit ID. Older requests may have no source kit ID, so they appear only in an unfiltered list. These tools read request summaries and do not expose conversation messages.

## Link in bio

| Tool                            | Role    | Scope               | Action                                                                                                                |
| ------------------------------- | ------- | ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `link_in_bio_get`               | Creator | `link_in_bio:read`  | Read the page, social links, blocks, and a page preview URL.                                                          |
| `link_in_bio_create`            | Creator | `link_in_bio:write` | Create one custom page with a slug and supported content.                                                             |
| `link_in_bio_update`            | Creator | `link_in_bio:write` | Update the profile, social links, or link/title/text blocks.                                                          |
| `link_in_bio_import_linktree`   | Creator | `link_in_bio:write` | Queue an import from a public Linktree or Beacons URL.                                                                |
| `link_in_bio_get_import_status` | Creator | `link_in_bio:read`  | Check an import using its returned ID.                                                                                |
| `link_in_bio_upsert_block`      | Creator | `link_in_bio:write` | Add or edit a link, title, text, image, video, or download block and return the page preview.                         |
| `link_in_bio_remove_block`      | Creator | `link_in_bio:write` | Permanently remove a selected block and return the page preview (destructive; the assistant confirms with you first). |

Call `link_in_bio_get` before creating or changing a page. New blocks need a stable `client_id`; existing blocks use their returned `id`. An import runs asynchronously and is available only when the creator has no page. See the [link-in-bio guide](/mcp/link-in-bio).

## Analytics

| Tool                               | Role            | Scope            | Action                                                                                                             |
| ---------------------------------- | --------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| `analytics_get_views`              | Creator, agency | `analytics:read` | Get page views, unique visitors, and a time series for one owned resource or an aggregate.                         |
| `link_in_bio_get_engagement`       | Creator         | `analytics:read` | Get page views, link clicks, unique viewers, and unique clickers for 7, 28, 90 days and lifetime.                  |
| `analytics_get_breakdown`          | Creator, agency | `analytics:read` | Break down owned media-kit or link-in-bio page views by referrer, country, device, browser, language, city, or OS. |
| `link_in_bio_get_link_performance` | Creator         | `analytics:read` | Compare recorded redirect clicks by active block for 7, 28, 90 days or lifetime.                                   |

`analytics_get_views` accepts `media_kit`, `link_in_bio`, `roster`, `deck`, or `campaign`. An optional `resource_id` narrows the result to one owned resource. Link-in-bio analytics are creator-only; roster and deck analytics are agency-only. Campaign views measure visits to a public CreatorsJet report, not views of social content.

## Social identities

| Tool            | Creator scope      | Agency scope   | Action                                                                |
| --------------- | ------------------ | -------------- | --------------------------------------------------------------------- |
| `social_list`   | `profile:read`     | `roster:read`  | List connected social identities without credentials.                 |
| `social_add`    | `media_kits:write` | `roster:write` | Add a social handle or profile URL and sync the relevant default kit. |
| `social_remove` | `media_kits:write` | `roster:write` | Remove a selected identity from the creator and associated kits.      |

Agency calls require an owned roster `creator_id`; creator calls use the signed-in creator. Supported platforms are `instagram`, `tiktok`, `youtube`, `facebook`, `linkedin`, `twitter`, `x`, `twitch`, `snapchat`, and `threads`. An assistant must identify the account and get confirmation before `social_remove`.

## Agency roster

| Tool                       | Scope          | Action                                                                            |
| -------------------------- | -------------- | --------------------------------------------------------------------------------- |
| `roster_validate_import`   | `roster:write` | Validate 1–500 normalized creator rows and create a 30-minute preview when valid. |
| `roster_commit_import`     | `roster:write` | Commit an approved preview and queue the import. Reuse returns the same import.   |
| `roster_get_import_status` | `roster:read`  | Check progress, created IDs, and row failures.                                    |
| `roster_add_creator`       | `roster:write` | Add or link one creator and ensure the agency kit exists.                         |

The assistant parses an attached CSV or spreadsheet into rows; MCP does not receive the raw file. Before committing, it must show the row count, validation result, and capacity impact and obtain approval.

## Agency pitch decks

| Tool          | Scope         | Action                                                                |
| ------------- | ------------- | --------------------------------------------------------------------- |
| `deck_list`   | `decks:read`  | List owned decks.                                                     |
| `deck_get`    | `decks:read`  | Read one deck and its selected creator IDs.                           |
| `deck_create` | `decks:write` | Create a deck from creators already in the agency roster.             |
| `deck_update` | `decks:write` | Update selection, copy, supported branding, slug, or access settings. |

Password input is write-only. These tools do not upload deck images or delete a deck.

## Campaigns

| Tool              | Role   | Scope             | Action                                                                   |
| ----------------- | ------ | ----------------- | ------------------------------------------------------------------------ |
| `campaign_list`   | Agency | `campaigns:read`  | List owned campaigns, with an optional status filter.                    |
| `campaign_get`    | Agency | `campaigns:read`  | Read one campaign's supported settings.                                  |
| `campaign_create` | Agency | `campaigns:write` | Create a campaign within the active-campaign allowance.                  |
| `campaign_update` | Agency | `campaigns:write` | Update metadata, dates, tracking cadence or state, CPM, or EMV override. |

Campaign tools are agency-only. Automatic tracking requires a future end date. MCP does not manage participants, content, report publication, refresh execution, or campaign deletion.

## Find sponsors

| Tool                        | Role                     | Scope               | Action                                                                                                                     |
| --------------------------- | ------------------------ | ------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `sponsor_directory_options` | Creator Max, agency Pro+ | `sponsorships:read` | List the valid industries, countries, and categories for directory searches.                                               |
| `sponsor_search_brands`     | Creator Max, agency Pro+ | `sponsorships:read` | Find brands by category, industry, country, company size, or name, 25 per page.                                            |
| `sponsor_get_brand`         | Creator Max, agency Pro+ | `sponsorships:read` | Read one brand's description, social URLs, and technology list.                                                            |
| `sponsor_search_contacts`   | Creator Max, agency Pro+ | `sponsorships:read` | List influencer-marketing contacts, usually at one brand, with LinkedIn URLs and already-revealed emails.                  |
| `sponsor_get_contact`       | Creator Max, agency Pro+ | `sponsorships:read` | Read one contact's headline, skills, and job history.                                                                      |
| `sponsor_lookup_brand`      | Creator Max, agency Pro+ | `sponsorships:read` | Find a brand and its contacts by website URL, importing them when the directory lacks them. Uses a daily discovery budget. |
| `sponsor_reveal_email`      | Creator Max, agency Pro+ | `sponsorships:read` | Reveal one contact's verified work email. Cached emails are free; new reveals request the data provider.                   |

Find sponsors is for independent creator accounts and agencies. Every Find sponsors tool requires Creator Max or an agency Pro, Scale, or Enterprise plan, the tier that unlocks brand and contact identities in the web app. The assistant should name the contact and get your confirmation before revealing an email. Find sponsors is not part of Public API V1.

For confirmation rules, plan limits, and errors, see [permissions and safety](/mcp/safety-and-plans).