# How to connect Starcovery to Claude

```json
{
  "title": "How to connect Starcovery to Claude",
  "toolkit": "Starcovery",
  "toolkit_slug": "starcovery",
  "framework": "Claude Cowork",
  "framework_slug": "claude-cowork",
  "url": "https://composio.dev/toolkits/starcovery/framework/claude-cowork",
  "markdown_url": "https://composio.dev/toolkits/starcovery/framework/claude-cowork.md",
  "updated_at": "2026-11-19T05:38:18.649Z"
}
```

## Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.
This guide walks you through the easiest and most secure way to connect your Starcovery account to Claude via Composio Connect, enabling it to find fitness creators on YouTube, research creator profiles and recent videos, track outreach campaign contacts and statuses, and more such actions on your behalf without compromising your account security.
Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/starcovery).

## Also integrate Starcovery with

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

## Connect Starcovery to Claude Cowork

### Connecting Starcovery to Claude Web, Desktop, and Cowork
Two ways to add the Composio connector. Pick whichever you prefer.
### 1. Add with one click
Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.
[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Composio&connectorUrl=https%3A%2F%2Fconnect.composio.dev%2Fmcp)
### Add manually
In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.
Click Add custom connector and paste in the Composio MCP server URL:

```bash
https://connect.composio.dev/mcp
```

## What is the Starcovery MCP server, and what's possible with it?

The Starcovery MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Starcovery account. It provides structured and secure access to creator discovery, profile and video research, and outreach campaign management, so your agent can find creators, evaluate profiles and videos, build shortlists, and manage campaign workflows on your behalf.
- Creator discovery and research: Have your agent parse a natural-language brief, search Instagram and TikTok creators by platform, follower tier, and country, and retrieve stored search results.
- Campaign planning and shortlists: Let the agent create campaigns, generate ranked creator matches, add or remove creators from shortlists, update campaign details, and export visible shortlists as CSV.
- Profile and video investigation: Direct your agent to look up Instagram or TikTok videos, inspect creator account details returned for cataloged videos, and reveal a creator's contact address.
- Creator outreach workflows: Instruct your agent to upload campaign attachments, request campaign funding for accepted creators, and request proposal sends for Starcovery staff to handle.
- Campaign and search management: Have your agent list campaigns, read campaign details and chats, open durable search threads, run or stop thread turns, and review the organization's billing state.

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

## Troubleshooting

### 1. Why does Claude not use the Composio connector for Starcovery?

The connector can show as connected, but Claude must use it in each Starcovery conversation.
- Click + at the lower left of the chat, or type /.
- Hover Connectors.
- Turn on Composio.
- Ask Claude to connect to Starcovery again.

### 2. Why does Claude show an MCP server error before Starcovery connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Starcovery.
- Check that the connector URL is https://connect.composio.dev/mcp.
- Connectors run from Anthropic's cloud, so your device network is usually not the problem.
- Add the connector again from Customize > Connectors, then ask Claude to connect Starcovery.
- If it fails again, send the error and the ofid_ reference id to support@composio.dev.

### 3. Why does the Starcovery authorization link not work?

The Composio connector is one server. Your Starcovery account connects separately when Claude asks for it.
- If the browser does not open, or the link expires, ask Claude to retry the Starcovery connection.
- Composio creates a fresh Starcovery authorization link.
- Open that link in your browser and finish the Starcovery sign-in.

### 4. Why do Starcovery actions fail after they worked before?

The Starcovery connection can expire or lose permission.
- Ask Claude to inspect the Starcovery connection.
- If the connection is unhealthy, disconnect it when Claude prompts you.
- Reconnect the Starcovery account and retry the action.
- If Claude shows a permission prompt, approve it before Claude changes data in Starcovery.
- If the action still fails with a permission error, check that the connected account has that permission in Starcovery itself.

### 5. How do I switch to a different Starcovery account?

Claude can manage the Starcovery connection for you.
- Ask Claude to disconnect or delete the current Starcovery account.
- Ask Claude to connect Starcovery again.
- Open the new Composio authorization link for Starcovery.
- Sign in with the other Starcovery account in the browser.
- After the account connects, ask Claude to retry the Starcovery task.

### 6. Why is my Starcovery connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Starcovery connection works in Claude Web, Desktop, and Cowork.
- In Claude Desktop, open Customize > Connectors.
- Next to Composio, click ⋮ and click Clear cache.
- If Starcovery tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
- On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Starcovery.

## Creating MCP Server - Stand-alone vs Composio SDK

The Starcovery MCP server connects Claude Web, Desktop, and Cowork to your Starcovery account through Composio. Once connected, Claude can use the available Starcovery tools and triggers to complete tasks on your behalf.

## Complete Code

None listed.

## How to build Starcovery MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/starcovery/framework/chatgpt)
- [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

### What are the differences in Tool Router MCP and Starcovery MCP?

With a standalone Starcovery MCP server, the agents and LLMs can only access a fixed set of Starcovery tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Starcovery and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Claude Cowork?

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Starcovery tools.

### Can I manage the permissions and scopes for Starcovery while using Tool Router?

Yes, absolutely. You can configure which Starcovery scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Starcovery data and credentials are handled as safely as possible.

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