com.starcovery/mcp

Starcovery

MCP tools to find and hire Instagram and TikTok creators from a plain-language brief.

1.0.0
Version
remote
Transport
28
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 28 tools scanned
  • metadata: scanned

No findings.

Tools (28)

  • search_creators

    Search Instagram and TikTok creators with a natural-language brief. Returns ranked creators with fit score, follower count, platform, recent videos, and a shortlist enrichment ticket when available. Contact addresses stay empty until reveal_contact. Holds the call open until the result, up to 800 seconds. Each search is one use. Unsigned callers get 100 uses per rolling 24 hours per IP. Identified callers get 200 uses per rolling 24 hours, then prepaid credits. Pre-claim agent tokens skip the daily grant and use prepaid credits only. Pass creators, query.q, and ticket to enrich_creators for niche, evidence, and signal analysis.

  • enrich_creators

    Run shortlist AI enrichment (niche, celebrity, evidence, signal) for creators from search_creators. Pass the same creators array, query string (search query.q), and ticket. Returns one analysis object per creatorId. The ticket is single-use and bound to the search caller, and enrichment spends no credits. Holds the call open until the result, up to 800 seconds.

  • reveal_contact

    Reveal a creator contact address. Costs 1 prepaid credit the first time this organization reveals that profile. Later calls return the address without charging. Needs a credential.

  • list_campaigns

    List the caller's campaigns with goal, status, visibility, match counts, and nextStep: the step the web app shows next, with its id, label, actor (you for the organization, starcovery, creators, or one creator by name), and line, the sentence that says what the step waits on. nextStep is null once no step is left: the campaign is done or archived, or no creator was reached or accepted. Needs a credential.

  • get_campaign

    Get one campaign and its matched creators. Ordinary public campaigns are free to read for any identified caller. A private campaign reads as not found for a caller outside the organization. Contract, creator posting date, campaign details declassifying date, and disclosure are present for members of the organization and may be null on open and summary reads. For members of the organization, people lists each person on the campaign once, with their profiles, their answer to the proposal, their funding (requested or funded), and their signed hire with the payout amount, paidAt (null while the payout is pending), and posts, each live post Starcovery recorded with its link, viewCount, and engagementCount (likes plus comments); people also lists a hire that matches no creator on the campaign, and is null for other callers. Count hires and payouts from people. For members of the organization, nextStep names the step the web app shows next, as list_campaigns does; it is null for other callers

  • create_campaign

    Create a campaign with a goal (what to advertise or attain). A campaign is public and free by default; setting visibility "private" costs 1 credit. Contract (deliverable, compensationCents, and platforms, the platforms one payment covers), creator posting date, campaign details declassifying date (embargoUntil), disclosure, and marketInformation are accepted. Optional creators adds them as manual matches in the same call, as add_campaign_matches does, and the result carries matches with the added and present counts; a creator id outside the catalog fails the call before anything is created or charged. Needs a credential.

  • update_campaign

    Update campaign fields: name, goal, visibility, or status (draft, archived, or active; Starcovery sets active when the team sends the proposals, and active reopens an archived campaign whose proposals were sent). A campaign that is active or holds a delivery cannot return to draft, a campaign with an open send or funding request cannot be archived, and a campaign that is not archived or was never sent cannot be set active; each change returns a tool error naming the reason. Changing visibility to private costs 1 credit; already-private updates do not. Contract (deliverable, compensationCents, and platforms, the platforms one payment covers), creator posting date, campaign details declassifying date (embargoUntil), disclosure, and marketInformation are accepted. Null marketInformation clears it. After the campaign's first funding request, a changed or cleared marketInformation returns a tool error naming the reason. After Starcovery sends the proposals, a changed or cleared contract ret

  • delete_campaign

    Delete a campaign and its matches. A funded campaign, a campaign with a signed hire, or a campaign with a proposal delivery returns a tool error naming the reason. Needs a credential.

  • generate_campaign_matches

    Generate creator matches from the campaign goal. Runs one creator search (same daily grant and prepaid credits as search_creators; pre-claim agent tokens spend prepaid credits only) and saves matches; idempotent on (campaign, profileId). Optional filters narrow the search. Holds the call open until the result, up to 800 seconds. While a send request is open, once the campaign is sent, or while it is archived, it returns a tool error naming the reason before any search runs. Needs a credential.

  • add_campaign_match

    Add a creator as a manual match to a campaign. Idempotent on (campaign, profileId). Stores the platform, handle, name, picture, and follower count of the catalog profile and keeps only profileId and fitScore from the input; a profileId with no catalog profile returns not_found. While a send request is open, once the campaign is sent, or while it is archived, it returns a tool error naming the reason. Needs a credential.

  • add_campaign_matches

    Add several creators as manual matches to a campaign in one call. Idempotent on (campaign, profileId). Stores the platform, handle, name, picture, and follower count of each catalog profile, keeps only profileId and fitScore from the input, and drops a profileId with no catalog profile. Returns added, the count of new matches, and present, the count already on the campaign, with addedCreators and presentCreators, the same counts per person, so a person with two matched profiles counts once. A campaign outside the caller's organization returns not_found. While a send request is open, once the campaign is sent, or while it is archived, it returns a tool error naming the reason. Needs a credential.

  • remove_campaign_match

    Remove one matched creator from a campaign by match id. A match that already has a proposal delivery, or any match while a send request is open, once the campaign is sent, or while it is archived, returns a tool error naming the reason. Needs a credential.

  • list_campaign_attachments

    List the files attached to a campaign of the caller's organization, with id, filename, content type, byte size, and upload time. Returns no file contents. A campaign outside the caller's organization returns not_found. Needs a credential.

  • delete_campaign_attachment

    Delete one file attached to a campaign of the caller's organization. Irreversible. An attachment or a campaign outside the caller's organization returns not_found. Needs a credential.

  • export_campaign

    Export a campaign as CSV (Rank, Handle, Name, Platform, Followers, Fit, Source). Same access as get_campaign. Needs a credential.

  • send_campaign

    Request a proposal send for a draft campaign the caller's organization owns. Starcovery Proposals runs concierge: this call records one open send request and notifies the Starcovery team, who send the proposals from the staff queue. Nothing is mailed by this call. Needs a saved contract whose creator posting date, when set, is today or a later day in UTC, a captured disclosure, and at least one match. Returns a tool error naming the reason when the campaign is not the caller's, a step is missing, a request is already open, or the campaign is already sent. Returns the request row. Needs a credential.

  • fund_campaign

    Request campaign funding for a campaign the caller's organization owns. Starcovery Payouts runs concierge: this call records one open funding request for the accepted creators not yet funded, per person, with the quoted total (compensation per creator times those people, plus the platform fee that the market information answer sets), and notifies the Starcovery team, who invoice the organization. No money moves by this call. Only organization owners and admins may call it. Needs a saved contract, an answered market information question, and at least one creator who accepted and is not yet funded. Returns a tool error naming the reason when the campaign is not the caller's, it is archived, a step is missing, or a request is already open; reopen an archived campaign with update_campaign status active first. The reason creators_changed means a creator accepted while the request was prepared, and the caller repeats the same call. Returns the request row with amountCents set to the quoted

  • whoami

    Show the current credential, the bound user and organization, and whether the next search draws from the user daily grant or the organization balance. Needs a credential.

  • get_credits

    Read the prepaid credit balance, the identified daily search grant status, the last pack, and whether a card is on file. Does not start checkout or change payment settings. Needs a credential.

  • list_api_keys

    List API keys for the active organization (id, name, prefix, timestamps). An owner or admin sees every key; a member sees only the keys they minted. Never returns plaintext keys. Needs a credential other than an agent access token or an OAuth access token.

  • create_api_key

    Mint a new API key. Returns the plaintext key once; store it immediately. Needs a credential other than an agent access token or an OAuth access token.

  • revoke_api_key

    Revoke an API key by id. An owner or admin revokes any key of the organization; a member revokes only a key they minted, and another key returns not_found. Irreversible. Needs a credential other than an agent access token or an OAuth access token.

  • thread_turn

    Run the next turn of a search thread and return the settled brief, its filters, the operations the turn ran, the reply, and the creators of the thread result set with a shortlist enrichment ticket. Omit threadId to open a new thread; the threadId in the result is the durable handle for the next turn. A pasted website address is read into a brief; anything else refines the brief, or answers a question about the organization's campaigns, Lists, credits, or API keys from read tools without changing them. Sends notifications/progress when the caller passes a progressToken. MCP cannot stream a tool result, so the call is blocking and waits until the turn ends, up to 800 seconds. Each turn costs 1 use plus 1 for each search and each exclusion it runs, from the same daily grant as search_creators and then 1 prepaid credit each. A refinement returns the set it built; the first brief runs one search for its creators, billed like search_creators. The thread stores the set, so reading it again

  • intersect_lists

    Keep the creators that appear in both lists, in the order of the left list. Nothing is stored. Map a search_creators result to the saved creator shape first: profileId is the creator id, and fitScore, followerCount, name, platform, profileImageUrl, and username carry over. Needs a credential.

  • save_list

    Save a set of creators as a List for the organization, with the brief and filters of the search that produced it. The List takes the name in name, or a name cut from the brief when name is omitted, with a number from 2 appended when another List of the organization holds that name. Map a search_creators result to the saved creator shape first: profileId is the creator id, and fitScore, followerCount, name, platform, profileImageUrl, and username carry over. The List stores the platform, handle, name, picture, and follower count of each catalog profile, keeps only profileId and fitScore from the input, and drops a profileId with no catalog profile. Returns the saved List summary. Needs a credential.

  • list_lists

    List the organization's saved Lists with brief, filters, creatorCount (each person once), itemCount (each saved profile), and last update. Needs a credential.

  • get_list

    Get one List of the caller's organization with its brief, filters, and saved creators, best fit first. The creators carry the saved creator shape that add_campaign_matches, create_campaign, and intersect_lists take. A List outside the caller's organization returns not_found. Needs a credential.

  • delete_list

    Delete one List of the caller's organization and its saved creators. Campaigns keep the creators added from it. Irreversible. A List outside the caller's organization returns not_found. Needs a credential.