---
name: starcovery
description: Find, hire, cross-post, measure, and pay out Instagram and TikTok creators from one brief. Search with no account, connect MCP or CLI with a key or sign-in that a person gives you, and run campaigns. Use when the user mentions Starcovery, creator search, influencer search, Instagram or TikTok creators, or hiring creators from an agent.
---

# Starcovery

This file is a host trigger. Fetch https://www.starcovery.com/agents and follow it before you ask a person for a credential, pay, or when a response includes authUrl. Do not copy that document into this file.

## Install

Install this skill with:

If bun is on PATH:

    bunx skills add https://www.starcovery.com --global --yes --skill starcovery --agent cursor --agent claude-code --agent codex

Otherwise:

    npx -y skills add https://www.starcovery.com --global --yes --skill starcovery --agent cursor --agent claude-code --agent codex

That is global, non-interactive, and targets Cursor, Claude Code, and Codex. Do not write a project .cursor/skills directory by hand.

Claude Desktop has no skills CLI agent id. Download https://www.starcovery.com/agents/skill.zip and upload it at **Customize** > **Skills** with code execution on. The Model Context Protocol (MCP) connector is separate, at https://www.starcovery.com/api/mcp.

## Search

Unsigned search works without a credential, with 100 uses per UTC day per IP, where a search through the API is one use and a thread turn is one use plus one for each new search and each exclusion it runs, so a new search typed on the website is two:

    GET https://www.starcovery.com/api/search?q=coffee

    starcovery search searchCreators --q coffee

Search, campaign generate, and shortlist enrich hold the request open until the result; the api ends a request at 800 seconds.

Identified callers get 200 uses per UTC day, and the members of one organization share at most 200, then prepaid credits.

POST /api/search/enrich is the same analysis as the **Table** view of web search results and spends no prepaid credits. The MCP tool is enrich_creators. Pass query.q from the search_creators result as the enrich_creators query, and the shortlistId it returned. The REST endpoint and the CLI take the search result ticket instead.

## Get a credential

Search needs none. Everything else needs a Settings API key or an OAuth sign-in that a person gives you from their Starcovery account. Credentials, credits, and MCP details live at https://www.starcovery.com/agents. OpenAPI: https://www.starcovery.com/openapi.json.

## Campaigns

A credential is required. Ordinary public reads are free for identified callers. A campaign opens only to its organization until its proposals are sent. Setting a campaign to private costs 1 credit.

`list_campaigns`, `get_campaign`, `GET /api/campaigns`, and `starcovery campaigns listCampaigns` name the next step of each campaign of the organization in `nextStep`: its `id`, its `label`, the `actor` who takes it (you, starcovery, creators, or one creator by name), and the `line` the web app shows. It is null once no step is left. `get_campaign` and `GET /api/campaigns/{campaignId}` also list every step under way in `currentSteps`, in campaign order and the same shape, because a step before `nextStep` can still wait; read `currentSteps` to tell whether a step is finished.

`request_campaign_send` and `request_campaign_funding` record one open request each and notify the Starcovery team, who send the proposals and invoice the organization. Send needs draft status, a contract whose creator posting date, when set, is today or a later day in UTC, a disclosure, and at least one match. Fund needs an owner or admin caller, a contract, market information, and at least one creator who accepted the proposal; it covers only the accepted creators not yet funded, one per person. A gate that fails or an open request returns the reason as a tool error.

REST: `POST /api/campaigns/{campaignId}/send-request` and `POST /api/campaigns/{campaignId}/funding-request` (201 with the request row in `request`, 409 `campaign_request_denied`, 403 `organization_funding_forbidden`).
