Starcovery

Add a creator as a manual match to a campaign by profileId, with its fitScore. Idempotent on (campaign, profileId). Stores the platform, handle, name, picture, and follower count of the catalog profile, so the input carries nothing else, and any other key, platform or username included, fails the call with a validation error; 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 several creators as manual matches to a campaign in one call. Each creator is a profileId and fitScore pick: the id and fitScore of a search_creators creator, or the profileId and fitScore of a get_list creator. Idempotent on (campaign, profileId). Stores the platform, handle, name, picture, and follower count of each catalog profile, so a creator carries nothing else, and any other key on a creator fails the call with a validation error. A profileId outside the catalog fails the call with a tool error naming it, and nothing is added. 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.

Return the Starcovery page that opens one invitation from list_received_invitations with Accept and Decline, for the person to answer in their signed-in browser. Opening the page answers nothing. Needs a credential.

Accept or decline one proposal from list_received_proposals on behalf of the caller's organization. Accepting tells the hiring organization the creator takes the campaign on its contract. Returns a tool error naming the reason when the answer cannot be recorded, such as a proposal outside the organization. Needs a credential.

Cancel the open send request of a campaign the caller's organization owns, before the Starcovery team sends the proposals, so the campaign is a draft again and request_campaign_send can ask again. Only an organization owner may call it. Returns a tool error naming the reason when the caller is not an owner, the campaign is not the caller's, it is already sent, or it holds no open send request. Returns the cancelled request row. Needs a credential.

Return the Starcovery page that asks the person to give a member of the caller's organization the owner, admin, or member role, in their signed-in browser. Opening the page changes nothing. No setting turns an owner back into an admin or a member. Only owners and admins may call it. Needs a credential.

Pick the organization, one the calling user belongs to, that takes the credits of one waiting reward from list_rewards. Returns a tool error naming the reason when the reward is no longer waiting, the user is not a member of that organization, or a reward cap is reached. Needs a credential.

Mint a new API key. Only an organization owner can mint one; an admin or member is refused. Returns the plaintext key once; it is not shown again. The new key is an ordinary key of the same member, not a child of the minting key: revoking the minting key leaves it working. Needs a credential other than an OAuth access token.

Create a campaign with a goal (what to advertise or attain). A campaign opens only to its organization until its proposals are sent, at no charge. It is public and free by default, which opens it to any identified caller once sent; setting visibility "private" costs 1 credit and keeps it to the organization after the send. 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, each a profileId and fitScore pick, 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; any other key on a creator fails the call with a validation error; a creator id outside the catalog fails the call before anything is created or charged. Needs a credential.

Return the Starcovery page that opens the Create an organization dialog with the name filled in, for the person to confirm in their signed-in browser. Opening the page changes nothing. Needs a credential.

Return the Starcovery page that lists what goes with the account and asks the person to delete it, in their signed-in browser. Opening the page deletes nothing. Needs a credential.

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.

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.

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.

Return the Starcovery page that asks the person to type the organization name and delete the caller's organization, with its campaigns, Lists, and credits, in their signed-in browser. Opening the page deletes nothing. Only an owner may call it. Needs a credential.

Remove one entry from the organization's search history by its id. Running that search again then spends a use like a new search. An id outside the organization returns not_found. Needs a credential.

Run shortlist AI enrichment (niche, celebrity, evidence, signal) for creators from search_creators. It takes the same creators array, query string (search query.q), and the shortlistId search_creators returned with them. Returns one analysis object per creatorId. A shortlistId works once, for 4 hours, and only for the caller who searched; enrichment spends no credits. Holds the call open until the result, up to 800 seconds.

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

Generate creator matches from the campaign goal. Runs one creator search (same daily grant and prepaid credits as search_creators) 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.

Get one campaign and its matched creators. Ordinary public campaigns whose proposals are sent are free to read for any identified caller. A private campaign, and any campaign whose proposals are not yet sent, 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. Hires and payouts are counted in 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 and once no step is left. currentSteps lists every step under way in campaign order in the same shape, because a step before nextStep can still wait, such as proposals Starcovery has not sent; currentSteps, not nextStep or status, tells whether a step is finished. It is null for other callers and empty once no step is left. Needs a credential.

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

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 intersect_lists takes. add_campaign_matches, create_campaign, and save_list take only the profileId and fitScore of each. A List outside the caller's organization returns not_found. Needs a credential.

Read the caller's organization: its name, the caller's role, the members with their id, name, email address, and roles, the invitations it has sent that are still open, whether the caller is its only owner, and the reason it cannot be deleted, if any. Needs a credential.

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

Return the Starcovery page that opens the Invite a member dialog of the caller's organization with the address and role filled in, for the person to send in their signed-in browser. Opening the page sends nothing. Only owners and admins may call it. Needs a credential.

Return the Starcovery page that asks the person to leave the caller's organization, in their signed-in browser. Opening the page changes nothing. The only owner cannot leave. Needs a credential.

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 OAuth access token.

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.

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.

List the agents connected over OAuth: organizationAgents, the agents approved for the caller's organization, every member's for an owner or admin and only their own for a member, and accountAgents, the agents the calling user approved in every organization. Never returns a token. Needs a credential other than an OAuth access token.

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

List the organizations the calling user belongs to, with each one's id, name, and the user's roles, and the id of the organization this credential acts in. Needs a credential.

List the invitations to other organizations sent to the calling user's email address, with each one's id, organization, role, and state. Needs a credential.

List the campaign proposals sent to the creator handles the caller's organization verified, each with its deliveryId, the campaign and the organization hiring, the handle, the contract, and the answer so far. Needs a credential.

Read the calling user's rewards: the posts submitted for shoutout credits with their review state, every reward waiting for the user to pick the organization that takes it, and the organizations the user can pick. Needs a credential.

List the organization's search history, the most recently run first, 50 entries a page: each entry's id, brief, and filters, how many times it ran, the credits it spent, who ran it, and when it last ran. A search still in this history repeats for free. Returns pageCount. Needs a credential.

Open the Stripe billing portal of the caller's organization, and return its page for the person to open. Only organization owners and admins may call it, and an organization that has never bought credits returns a tool error. Needs a credential.

Remove every agent the calling user approved, in every organization. Each loses access within an hour and works again only after the user approves it again. Needs a credential other than an OAuth access token.

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.

Return the Starcovery page that asks the person to remove a member from the caller's organization, in their signed-in browser. The member then loses access, and their API keys and the agents they approved for it stop working. Opening the page removes nothing. Only owners and admins may call it. Needs a credential.

Remove one agent from the caller's organization by its id in organizationAgents. It loses access within an hour and works again only after someone approves it again. A member removes only an agent they approved; another id returns not_found. Needs a credential other than an OAuth access token.

Return the Starcovery page that opens the account settings with the new full name filled in, for the person to save in their signed-in browser. Opening the page changes nothing. Needs a credential.

Rename one List of the caller's organization. A List outside the caller's organization returns not_found. Needs a credential.

Return the Starcovery page that opens the caller's organization settings with the new name filled in, for the person to save in their signed-in browser. Opening the page changes nothing. Only owners and admins may call it. Needs a credential.

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 $99 campaign price on the campaign's first funding request only, which Starcovery keeps and never refunds), and notifies the Starcovery team, who invoice the organization. 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. An archived campaign is funded only after it is reopened with update_campaign status active. The reason creators_changed means a creator accepted while the request was prepared; the same call then succeeds. Returns the request row with amountCents set to the quoted total. Needs a credential.

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

Ask the Starcovery team to hand-pick creators for a brief and its filters. The team replies within 2 days to the calling user's email address, or, for a caller without a credential, to the address in email, which that caller must pass. Shares the hourly limit of send_feedback, per user or per IP; past it, it returns a tool error. Returns the address the reply goes to.

Ask the Starcovery team to open payouts for the caller's organization, so it can receive creator pay. The team then sends an invite that asks for the bank details and tax documents. Only organization owners and admins may call it, and the organization needs a verified handle claim first; otherwise it returns a tool error naming the reason. Returns the payout account state. Needs a credential.

Return the Starcovery page that asks the person to send an open invitation of the caller's organization again, in their signed-in browser. Opening the page sends nothing. An invitation id outside the organization's open invitations returns not_found. Needs a credential.

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

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, and touches only that key: keys minted with it stay enabled until revoked by id. Needs a credential other than an OAuth access token.

Return the Starcovery page that asks the person to revoke an open invitation of the caller's organization, in their signed-in browser. Opening the page revokes nothing. An invitation id outside the organization's open invitations returns not_found. Needs a credential.

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. Each creator is a profileId and fitScore pick: profileId is the creator id from search_creators, and fitScore its fit. The List stores the platform, handle, name, picture, and follower count of each catalog profile, so a creator carries nothing else, and any other key on a creator fails the call with a validation error. A profileId outside the catalog fails the call with a tool error naming it, and no List is saved. Returns the saved List summary. Needs a credential.

Search Instagram and TikTok creators with a natural-language brief. Returns up to 50 ranked creators with fit score, follower count, platform, the 3 best-matching videos, and a shortlistId for enrich_creators when available. Bios and captions are cut to 150 characters. The creator's website link is returned as written, or null when it is longer than 200 characters. Every other link is a short link that redirects for 24 hours. When the result would pass 140,000 characters, the lowest ranked creators are left out until it fits. The brief in q sets no filter; platform, country, and tier filter. Contact addresses stay empty until reveal_contact. Holds the call open until the result, up to 800 seconds. Each search is one use. A caller without a credential gets 100 uses per IP per UTC day, shared with thread_turn and with signed-out use of the web app and the REST API, so everyone behind one IP shares them. Identified callers get 200 uses per rolling 24 hours, with at most 200 shared by everyone in their organization, then prepaid credits. enrich_creators takes these creators, query.q, and shortlistId for niche, evidence, and signal analysis.

Send one bug or feature report about a site path to the Starcovery team. The report records the path and whether the caller sent a credential, never the account. Each user, or each IP for a caller without a credential, may send only a few reports per hour; past that it returns a tool error. Returns the report reference.

Return the Starcovery page that asks the person to sign out every other browser session of their account, in their signed-in browser. Opening the page signs out nothing. Needs a credential.

Start a Stripe Checkout for one prepaid credit pack for the caller's organization, and return its page for the person to open and pay there. Nothing is charged until they pay on that page. Only organization owners and admins may call it. Needs a credential.

Start a claim of one Instagram or TikTok creator handle for the caller's organization, or return the claim the organization already holds. The claim waits in review with a verificationCode: the creator sends that code by direct message from the claimed profile, and the Starcovery team approves it. Returns a tool error naming the reason when no catalog profile has the handle, another organization holds or is claiming it, a takedown covers it, or the organization already has its limit of claims in review. Needs a credential.

Submit the address of a post about Starcovery, on a blog, Instagram, or TikTok, for review, crediting the caller's organization when it is approved. Each post is reviewed, and an approved post earns credits. Returns a tool error naming the reason when the address is no post, is on another platform than the one named, was already submitted, or passes the hourly limit. Returns the submitted claim. Needs a credential.

Return the Starcovery page that asks the person to make another of their organizations active in their browser. Opening the page changes nothing until they confirm. A credential stays bound to its own organization. Needs a credential.

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 shortlistId for enrich_creators. creatorCount counts the whole set; creators holds at most the 50 best fit of them, fewer when the result would pass 140,000 characters. The reply, statement, and error are cut to 4,000 characters, and operations lists at most the first 20. Without threadId the call opens a new thread; the threadId in the result is the durable handle for the next turn. When a limit refuses the turn of a call that opened its thread, the tool error is JSON with the refusal in error beside threadId and any threadKey, so retry that thread instead of opening another. A pasted website address is read into a brief; anything else refines the brief, or, with a credential, 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 a caller with a credential reads it again free with GET /api/threads/{threadId}/results. When the allowance runs out, exhausted is set and creators is empty; a turn that finds it spent runs nothing. Without a credential, each turn draws on the per-IP allowance of search_creators, and opening a thread counts against 100 thread starts per IP per 24 hours. The result then also holds threadKey, and the next turn of that thread passes threadKey with threadId.

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. While a funding request is open or the campaign holds funds, a changed or cleared marketInformation returns a tool error naming the reason; a campaign whose reserve was refunded to zero takes a new answer. After Starcovery sends the proposals, a changed or cleared contract returns a tool error naming the reason, and a call without contract still changes the other fields. Needs a credential.

Attach one file to a campaign the caller's organization owns: a PDF, a GIF, JPEG, PNG, or WebP image, a CSV, a JSON, or a plain text file, at most 4 MB, sent as base64. The campaign, the organization, and the user each have a file limit, and uploads per hour are limited; past either it returns a tool error naming the reason. A campaign outside the organization returns not_found. Needs a credential.

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.