How to integrate Starcovery MCP with Atomic Agent

Connect Atomic Agent to Starcovery MCP. Find fitness creators on youtube, research creator profiles and recent videos, and more using natural language, with authentication handled for you.

Starcovery logoStarcovery
Api Key

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.

38 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Starcovery.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Starcovery account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Starcovery with

How Atomic Agent connects to Starcovery

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Starcovery to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Starcovery. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Starcovery account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Starcovery from Atomic Agent

With your account connected, ask Atomic Agent to work with Starcovery in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Starcovery action and event your agent gets out of the box.

Add Campaign Match

Add one creator profile from Search Creators to a draft campaign's shortlist.

Call Hosted Tool

Run one Starcovery catalog tool through the native REST endpoint, not MCP, using its provider-native JSON input.

Cancel Campaign Send

Cancel a still-open proposal-send request before Starcovery staff send it.

Check Health

Check whether Starcovery's API service is up.

Create API Key

Mint an API key for the connected organization.

Create Campaign

Create a draft campaign with a name and creator brief.

Delete Campaign

Permanently delete a campaign and all of its shortlist matches.

Delete Campaign Attachment

Permanently delete one stored attachment from a campaign.

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.

Export Campaign

Export a visible campaign shortlist as exact CSV text with Rank, Handle, Name, Platform, Followers, Fit, and Source columns.

Generate Campaign Matches

Run one creator search from a campaign's goal and idempotently save ranked creators as shortlist matches.

Get Billing State

Read the organization's prepaid-credit balance, daily search grant, last purchased pack, and whether a card is on file.

Get Campaign

Get one campaign with its shortlisted creator matches and current workflow steps.

Get Campaign Attachment

Download one campaign attachment.

Get Campaign Chat

Read one visible campaign together with its attachment metadata.

Get Current Identity

Read the user, organization, credential kind, billing state, and source of the next search credit resolved from the connected API key.

Get Thread

Read a durable search thread without spending a search grant or prepaid credit.

Get Thread Results

Read the creator set stored by a thread, preserving its result order and single-use enrichment ticket.

List API Keys

List revocable API-key metadata for the connected organization.

List Campaigns

List the connected organization's campaigns, optionally filtered by status, with each campaign's match count and next workflow step.

List Hosted Tools

List Starcovery's hosted tool catalog with each tool's name, title, description, and input and output JSON Schemas.

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.

Open Thread

Open a free, durable search thread for the connected organization.

Parse Creator Search

Extract platform, follower-tier, and country filters from a natural-language creator brief before calling Search Creators.

Remove Campaign Match

Remove one undelivered, unlocked creator match from a campaign shortlist.

Request Campaign Funding

Create an open funding request for accepted, unfunded creators and immediately notify Starcovery staff to invoice the organization.

Request Campaign Send

Create an open proposal-send request and immediately notify Starcovery staff.

Resume Thread Stream

Reconnect to the currently open turn and replay its UI-message stream from the first chunk through the stored outcome.

Reveal Creator Contact

Reveal a creator's contact address.

Revoke API Key

Irreversibly revoke one organization API key by id.

Run Thread Turn

Run and store the next assistant turn, returning its ordered AI SDK UI-message chunks.

Search Creators

Rank Instagram and TikTok creators for a brief, optionally using explicit filters returned by Parse Creator Search.

Start Profile Claims

Start an Instagram handle claim, a TikTok handle claim, or both.

Stop Thread Turn

Record a stop for one run id, preventing that run from starting new searches, exclusions, or tool calls.

Submit Feedback

Submit a real bug or feature report to Starcovery staff, including the Starcovery site path it concerns.

Update Campaign

Update the name or creator brief of an existing campaign, or make it public.

Upload Campaign Attachment

Upload one attachment of at most 4 MiB to a campaign.

Verify Profile Claim

Read the current state of one handle claim by id.

FAQ

Frequently asked questions

Start with Starcovery.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Starcovery tool your agent needs.Free to start.

Start building