Tool reference
CreatorsJet MCP tools, account roles, permissions, and limits.
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, link in bio, or example requests.
Only tools allowed by your account role and approved OAuth scopes appear in the tool list. Existing owned content is readable on every active account; writes and premium sponsorship matching check plan eligibility. If a client requests no scopes, it receives standard read scopes by default. deals:read needs separate approval because requests contain 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 | Remove one selected item after explicit confirmation. |
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 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 | Remove a selected block after explicit confirmation and return the page preview. |
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.
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 | Creator, agency | campaigns:read | List owned campaigns, with an optional status filter. |
campaign_get | Creator, agency | campaigns:read | Read one campaign's supported settings. |
campaign_create | Creator, agency | campaigns:write | Create a campaign within the active-campaign allowance. |
campaign_update | Creator, agency | campaigns:write | Update metadata, dates, tracking cadence or state, CPM, or EMV override. |
Automatic tracking requires a future end date. MCP does not manage participants, content, report publication, refresh execution, or campaign deletion.
Sponsorship matches
| Tool | Role | Scope | Action |
|---|---|---|---|
sponsorship_find_matches | Creator | sponsorships:read | Find up to 20 eligible Sponsorship Intelligence matches. |
Sponsorship discovery is available through MCP to eligible accounts. It is not part of Public API V1.
For confirmation rules, plan limits, and errors, see permissions and safety.