How to integrate Starcovery MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Starcovery account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

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

Also integrate Starcovery with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Starcovery with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Starcovery

Ask your agent to connect to Starcovery, or simply request any Starcovery-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Starcovery connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Starcovery or request any Starcovery-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Starcovery connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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