# Starcovery

```json
{
  "name": "Starcovery",
  "slug": "starcovery",
  "url": "https://composio.dev/toolkits/starcovery",
  "markdown_url": "https://composio.dev/toolkits/starcovery.md",
  "logo_url": "https://logos.composio.dev/api/starcovery",
  "categories": [
    "advertising & marketing"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-19T05:38:18.649Z"
}
```

![Starcovery logo](https://logos.composio.dev/api/starcovery)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Starcovery MCP or direct API to discover creators, research profiles, analyze videos, and manage outreach campaigns through natural language.

## Summary

Starcovery is a creator discovery and outreach platform for researching profiles, videos, and campaigns.
It helps teams find the right creators and manage partnerships in one place.

## Categories

- advertising & marketing

## Toolkit Details

- Tools: 38

## Images

- Logo: https://logos.composio.dev/api/starcovery

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Starcovery.
  - Setup:
    - Configure Api Key credentials for Starcovery.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Find fitness creators on YouTube
- Research creator profiles and recent videos
- Track outreach campaign contacts and statuses

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `STARCOVERY_ADD_CAMPAIGN_MATCH` | Add Campaign Match | Add one creator profile from Search Creators to a draft campaign's shortlist. Repeating the same campaign and profile is idempotent and leaves one match. The shortlist cannot change while a send request is open or after the campaign is sent or archived. |
| `STARCOVERY_CALL_TOOL` | Call Hosted Tool | Run one Starcovery catalog tool through the native REST endpoint, not MCP, using its provider-native JSON input. Inspect List Hosted Tools and the selected tool's schema before calling. The runtime-selected tool may spend credits, mutate data, notify people, or trigger other external effects. A tool that could change an organization or account returns a web-app confirmation link; this REST call alone does not apply that change. |
| `STARCOVERY_CANCEL_CAMPAIGN_SEND` | Cancel Campaign Send | Cancel a still-open proposal-send request before Starcovery staff send it. Only an organization owner may do this. The call notifies no one, records who cancelled the request and when, and leaves the campaign in draft so its terms and shortlist can change. It cannot recall proposals staff already sent. |
| `STARCOVERY_CHECK_HEALTH` | Check Health | Check whether Starcovery's API service is up. This unauthenticated, free read changes no provider state. |
| `STARCOVERY_CREATE_API_KEY` | Create API Key | Mint an API key for the connected organization. Only an organization owner can perform this free operation. The plaintext secret is returned exactly once in the result and must be stored securely without logging it. |
| `STARCOVERY_CREATE_CAMPAIGN` | Create Campaign | Create a draft campaign with a name and creator brief. Starcovery defaults visibility to public when it is omitted, so this action deliberately omits visibility and creates the free public form. Private visibility costs one prepaid credit and is not supported by this action. This action does not send proposals, notify staff, fund creators, or add campaign terms. |
| `STARCOVERY_DELETE_CAMPAIGN` | Delete Campaign | Permanently delete a campaign and all of its shortlist matches. Starcovery rejects deletion when the campaign has any funding on record (including refunded funding), a signed hire, a delivered proposal on any match, an active/already-sent state, or an open proposal-send request. An organization owner must cancel an open send request before deleting the campaign. |
| `STARCOVERY_DELETE_CAMPAIGN_ATTACHMENT` | Delete Campaign Attachment | Permanently delete one stored attachment from a campaign. |
| `STARCOVERY_ENRICH_CREATOR_SHORTLIST` | Enrich Creator Shortlist | Consume a Search Creators response's single-use, caller-bound ticket to stream niche, celebrity, evidence, and signal analysis for that exact shortlist. The enrichment itself is free and spends no search credit, but the required prior search consumes one daily grant or, after exhaustion, one prepaid credit ($0.05). Enrichment may run for up to 800 seconds. Do not retry after the ticket has been admitted because it is single-use. |
| `STARCOVERY_EXPORT_CAMPAIGN` | Export Campaign | Export a visible campaign shortlist as exact CSV text with Rank, Handle, Name, Platform, Followers, Fit, and Source columns. This is free and read-only and does not modify the campaign or notify creators or staff. |
| `STARCOVERY_GENERATE_CAMPAIGN_MATCHES` | Generate Campaign Matches | Run one creator search from a campaign's goal and idempotently save ranked creators as shortlist matches. The campaign must be mutable: an open send request, sent campaign, or archived campaign is rejected. This uses one daily search grant or, after grant exhaustion, one prepaid credit ($0.05), changes the campaign shortlist, and may run for up to 800 seconds. |
| `STARCOVERY_GET_BILLING_STATE` | Get Billing State | Read the organization's prepaid-credit balance, daily search grant, last purchased pack, and whether a card is on file. This free read starts no checkout and changes no payment setting. |
| `STARCOVERY_GET_CAMPAIGN` | Get Campaign | Get one campaign with its shortlisted creator matches and current workflow steps. Organization stakeholders also receive available campaign terms, people, funding, hire, payout, and post state. |
| `STARCOVERY_GET_CAMPAIGN_ATTACHMENT` | Get Campaign Attachment | Download one campaign attachment. Downloads are capped at the provider's 4 MiB attachment limit and returned as a file reference; the response media type is preserved and the provider filename is reduced to a safe basename. |
| `STARCOVERY_GET_CAMPAIGN_CHAT` | Get Campaign Chat | Read one visible campaign together with its attachment metadata. This is free, read-only, and has no side effects. It does not return or create conversation turns and does not call MCP; use the separate native thread actions for the campaign conversation. |
| `STARCOVERY_GET_CURRENT_IDENTITY` | Get Current Identity | Read the user, organization, credential kind, billing state, and source of the next search credit resolved from the connected API key. This is a free, read-only identity check. |
| `STARCOVERY_GET_THREAD` | Get Thread | Read a durable search thread without spending a search grant or prepaid credit. Returns its brief, filters, result id, ordered stored messages, every admitted run id and state, and any active run. Use this after disconnecting instead of rerunning a turn: assistant replies are stored on the thread. |
| `STARCOVERY_GET_THREAD_RESULTS` | Get Thread Results | Read the creator set stored by a thread, preserving its result order and single-use enrichment ticket. Reading an existing set is free and runs no search. If the thread has a brief but no stored set, this call runs and stores one search using the daily grant or one prepaid credit after exhaustion; every later read of that set is free. A thread without a brief returns not found. |
| `STARCOVERY_LIST_API_KEYS` | List API Keys | List revocable API-key metadata for the connected organization. This free read returns identifiers and display prefixes, never plaintext secrets, and changes nothing. |
| `STARCOVERY_LIST_CAMPAIGNS` | List Campaigns | List the connected organization's campaigns, optionally filtered by status, with each campaign's match count and next workflow step. |
| `STARCOVERY_LIST_TOOLS` | List Hosted Tools | List Starcovery's hosted tool catalog with each tool's name, title, description, and input and output JSON Schemas. |
| `STARCOVERY_LOOKUP_VIDEO` | Look Up Video | Look up an Instagram or TikTok video URL in Starcovery's catalog and return its canonical identity, duration, creator account, caption hash, and sound when present. |
| `STARCOVERY_OPEN_THREAD` | Open Thread | Open a free, durable search thread for the connected organization. The call creates stored state even though the thread starts with no brief or messages; Starcovery exposes no thread-delete endpoint. Send the first brief and page context with Run Thread Turn, and retain the returned thread id for reads, stream replay, results, and stopping runs. |
| `STARCOVERY_PARSE_CREATOR_SEARCH` | Parse Creator Search | Extract platform, follower-tier, and country filters from a natural-language creator brief before calling Search Creators. This does not run a creator search or consume a daily search grant. |
| `STARCOVERY_REMOVE_CAMPAIGN_MATCH` | Remove Campaign Match | Remove one undelivered, unlocked creator match from a campaign shortlist. Starcovery rejects removal after proposal delivery or while the campaign has an open send request, has been sent, or is archived. |
| `STARCOVERY_REQUEST_CAMPAIGN_FUNDING` | Request Campaign Funding | Create an open funding request for accepted, unfunded creators and immediately notify Starcovery staff to invoice the organization. Owner or admin access is required, as are a contract, a market-information answer, and at least one accepted unfunded creator; archived campaigns must first be reopened. The quote includes creator compensation and, on the campaign's first funding request, a non-refundable $99, $499, or $999 campaign price based on company size. This call moves no money, but staff may issue that invoice and the campaign price is never refunded. |
| `STARCOVERY_REQUEST_CAMPAIGN_SEND` | Request Campaign Send | Create an open proposal-send request and immediately notify Starcovery staff. The campaign must be a draft with a contract, paid-partnership disclosure, at least one match, and no past creator posting date. This call does not mail creators itself, but staff may send proposals from their queue after the gates pass; the open request locks shortlist changes until it is cancelled or sent. |
| `STARCOVERY_RESUME_THREAD_STREAM` | Resume Thread Stream | Reconnect to the currently open turn and replay its UI-message stream from the first chunk through the stored outcome. This is free and does not run the turn again. A 204 response means there is no open turn, or the supplied run id is not the open run; it returns active=false with no events. Use Get Thread for stored messages and admitted run states after the turn closes. |
| `STARCOVERY_REVEAL_CREATOR_CONTACT` | Reveal Creator Contact | Reveal a creator's contact address. The organization's first successful reveal for this profile spends 5 prepaid credits ($0.25); later reveals are free. A profile with no contact data returns an error and is not charged. |
| `STARCOVERY_REVOKE_API_KEY` | Revoke API Key | Irreversibly revoke one organization API key by id. This free deletion cannot be undone and affects only that key; keys previously minted with it remain enabled until separately revoked. |
| `STARCOVERY_RUN_THREAD_TURN` | Run Thread Turn | Run and store the next assistant turn, returning its ordered AI SDK UI-message chunks. The fresh run id identifies this stream for replay and stopping. Each turn spends one daily search allowance use, plus one for every new search and exclusion; after the allowance, each use spends one prepaid credit. A failed turn is refunded. The reply is durable, so after a disconnect use Get Thread or Resume Thread Stream instead of rerunning it. Agent mode can mutate records; proposal sends, funding, destructive actions, and API-key revocation still wait for customer confirmation on the Starcovery site. |
| `STARCOVERY_SEARCH_CREATORS` | Search Creators | Rank Instagram and TikTok creators for a brief, optionally using explicit filters returned by Parse Creator Search. An uncached search uses the connected account's daily grant; after that grant is exhausted, it spends one prepaid credit ($0.05). |
| `STARCOVERY_START_PROFILE_CLAIMS` | Start Profile Claims | Start an Instagram handle claim, a TikTok handle claim, or both. This free operation creates durable manual-review state and emails the calling user a verification code and claim link for each claim in review. |
| `STARCOVERY_STOP_THREAD_TURN` | Stop Thread Turn | Record a stop for one run id, preventing that run from starting new searches, exclusions, or tool calls. A stop sent before the run starts still stops it. Work already started may finish, and the stream can remain open until a partial reply is stored; a run that started no work ends without a reply. The stop is scoped to this run id, does not stop a later run with a new id, and does not delete the durable thread. |
| `STARCOVERY_SUBMIT_FEEDBACK` | Submit Feedback | Submit a real bug or feature report to Starcovery staff, including the Starcovery site path it concerns. This sends the report immediately; it is not a local draft or preview. |
| `STARCOVERY_UPDATE_CAMPAIGN` | Update Campaign | Update the name or creator brief of an existing campaign, or make it public. Unset fields are omitted and remain unchanged. Changing a public campaign to private costs one prepaid credit, so private visibility is deliberately not available. This action cannot change campaign status, contract terms, disclosure, embargo, or market information. |
| `STARCOVERY_UPLOAD_CAMPAIGN_ATTACHMENT` | Upload Campaign Attachment | Upload one attachment of at most 4 MiB to a campaign. Supported media types are JSON, PDF, GIF, JPEG, PNG, WebP, CSV, and plain text. Starcovery limits attachments to 50 files or 100 MiB per campaign, 100 files or 200 MiB per user in an organization, and 250 files or 500 MiB per organization. It also limits each user to 20 uploads per 60 seconds. A quota rejection does not identify which limit was reached. |
| `STARCOVERY_VERIFY_PROFILE_CLAIM` | Verify Profile Claim | Read the current state of one handle claim by id. Despite the provider's operation name and POST method, this free action does not approve or mutate the claim; Starcovery staff approve claims manually. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Starcovery
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["starcovery"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["starcovery"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Starcovery tools with your agent

Send a request, execute the Starcovery tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Find 20 YouTube creators in the fitness niche with audiences in the United States and summarize their profiles and latest videos."}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find 20 YouTube creators in the fitness niche with audiences in the United States and summarize their profiles and latest videos." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Starcovery and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["starcovery"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["starcovery"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Starcovery request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Starcovery tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Find 20 YouTube creators in the fitness niche with audiences in the United States and summarize their profiles and latest videos.")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find 20 YouTube creators in the fitness niche with audiences in the United States and summarize their profiles and latest videos.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Starcovery Integration

- Supports both Starcovery MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for discovering creators, researching profiles and videos, and managing outreach campaigns

### 2. Managed Auth

- Securely stores and applies your Starcovery API key to tool requests
- Central place to manage, scope, and revoke Starcovery access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Starcovery
- Scoped, least privilege access to Starcovery creator and campaign resources
- Full audit trail of agent actions to support review and compliance

## Use Starcovery with any AI Agent Framework

Choose a framework you want to connect Starcovery with:

- [ChatGPT](https://composio.dev/toolkits/starcovery/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/starcovery/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/starcovery/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/starcovery/framework/atomic-agent)

## Related Toolkits

- [Metaads](https://composio.dev/toolkits/metaads) - Metaads is Meta's official Ads API that lets you manage, analyze, and optimize your Facebook and Instagram ad campaigns. Streamline ad operations and gain deeper insights with robust automation.
- [AdMakeAI](https://composio.dev/toolkits/admakeai) - AdMakeAI is an advertising platform for brand research, creative generation, and Meta campaign workflows. It helps teams create and manage ad assets faster through one REST API.
- [Adrapid](https://composio.dev/toolkits/adrapid) - Adrapid is a platform for rapid creation of digital marketing visuals using templates. It streamlines design workflows for banners, images, and HTML5 content with automation.
- [AdRoll](https://composio.dev/toolkits/adroll) - AdRoll is a digital marketing platform for managing advertising campaigns, audiences, and account-based marketing. It helps marketers retarget customers across channels and measure performance.
- [Adtraction](https://composio.dev/toolkits/adtraction) - Adtraction is an affiliate marketing platform for partner programs, tracking links, transactions, commissions, statistics, and payments. It helps advertisers and publishers manage performance marketing with clear reporting and payout workflows.
- [Adyntel](https://composio.dev/toolkits/adyntel) - Adyntel is an API that retrieves LinkedIn ads for any company using a domain or LinkedIn Page ID. Easily access competitive ad intelligence to power your marketing workflows.
- [Beaconstac](https://composio.dev/toolkits/beaconstac) - Beaconstac is a platform for creating and managing QR codes and proximity beacons. It helps businesses engage customers and track marketing performance with powerful analytics.
- [Bouncify](https://composio.dev/toolkits/bouncify) - Bouncify is an email verification service for single addresses and bulk lists. Use it to reduce bounces, protect sender reputation, and track verification credits.
- [Bulk Email Checker](https://composio.dev/toolkits/bulk_email_checker) - Bulk Email Checker is an email verification service for checking address validity, mailbox status, domains, and mail-server signals. It helps reduce bounces, spot risky emails, and keep outreach lists cleaner before you send.
- [Campaign cleaner](https://composio.dev/toolkits/campaign_cleaner) - Campaign cleaner is an email campaign optimization tool that boosts compatibility and deliverability across email clients. It helps marketers get better results by cleaning, enhancing, and ensuring high performance for every campaign.
- [Deadline funnel](https://composio.dev/toolkits/deadline_funnel) - Deadline Funnel lets you create personalized deadlines and timers for your marketing campaigns. It helps marketers boost conversions by adding authentic urgency to offers.
- [DeBounce](https://composio.dev/toolkits/debounce) - DeBounce is an email verification service for checking address validity, deliverability, and risk. It helps keep contact lists clean so your campaigns reach real inboxes.
- [Easy Email Verification](https://composio.dev/toolkits/easy_email_verification) - Easy Email Verification is an email validation service for checking single addresses and bulk lists. Use it to reduce bounces, clean contact data, and protect sender reputation.
- [Elastic Email](https://composio.dev/toolkits/elastic_email) - Elastic Email is an email delivery and marketing platform for transactional emails, campaigns, contacts, and reporting. Use it to send reliable emails, manage audiences, verify addresses, and track performance.
- [Fairing](https://composio.dev/toolkits/fairing) - Fairing is a post-purchase survey and attribution platform for ecommerce brands. It helps teams measure which marketing channels, campaigns, and customer touchpoints drive purchases.
- [GoDaddy MCP](https://composio.dev/toolkits/godaddy_mcp) - GoDaddy MCP is a domain discovery toolkit for checking availability and generating AI-powered name ideas. Use it to move from rough business keywords to practical domain options fast.
- [Google Ads](https://composio.dev/toolkits/googleads) - Google Ads is Google's online advertising platform for creating, managing, and optimizing digital campaigns. It helps businesses reach targeted customers and maximize return on ad spend.
- [Google AdSense](https://composio.dev/toolkits/google_adsense) - Google AdSense is a platform for managing website advertising, payments, and performance reports. It helps publishers monetize content and track ad revenue in one place.
- [Handwrite.io](https://composio.dev/toolkits/handwrite) - Handwrite.io is a direct mail service for creating physical handwritten card orders. It helps teams send personal cards with selectable handwriting, stationery, and tracking.
- [Inblog](https://composio.dev/toolkits/inblog) - Inblog is an AI-powered blogging platform for posts, authors, tags, redirects, design settings, analytics, and lead forms. Use it to manage SEO-focused content, measure performance, and capture blog leads in one place.

## Frequently Asked Questions

### Do I need my own developer credentials to use Starcovery with Composio?

Yes, Starcovery requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
