Skip to content
Starcovery

Starcovery developer resources

Starcovery developer resources: OpenAPI, MCP, CLI, and agent signup for Instagram and TikTok creator search.

Starcovery runs a creator campaign from a plain-language brief: find Instagram and TikTok creators, hire them, cross-post, measure, and pay out. Search ranks creators for the brief and shows sample videos.

Agents call search, campaigns, and credits over HTTP, Model Context Protocol (MCP), or the CLI. Humans use the same product from the web.

Guides and API reference

These pages cover the first search, credentials, MCP setup, and the REST endpoints.

Entry points for each surface

Each surface has one entry point.

SurfaceEntry point
Webwww.starcovery.com
REST APIGET https://www.starcovery.com/api/search?q=coffee
MCP (Streamable HTTP)https://www.starcovery.com/api/mcp
CLInpx starcovery search "coffee"

Search spend

Search spend depends on the caller.

  • Unsigned callers need no credential and get 100 uses per rolling 24 hours per IP.
  • Identified callers get 200 uses per rolling 24 hours per user, then spend prepaid credits. Pre-claim agent tokens spend prepaid credits only.
  • A search is one use, and a thread turn is one use plus one for each search it runs.

Each identified use beyond those 200 spends one prepaid credit. See Credits and payments.

Machine discovery

Agents find Starcovery's machine surfaces through these documents and conventions.

  • OpenAPI 3.1 for REST: openapi.json
  • RFC 9727 API catalog: https://www.starcovery.com/.well-known/api-catalog
  • Agent instruction file: llms.txt
  • MCP server card: https://www.starcovery.com/api/mcp/server-card
  • Agent skills index: https://www.starcovery.com/.well-known/agent-skills/index.json
  • Protected resource metadata: https://www.starcovery.com/.well-known/oauth-protected-resource
  • Authorization server metadata with the agent_auth block: https://www.starcovery.com/.well-known/oauth-authorization-server
  • Markdown for any Starcovery marketing page: append .md to the URL, or send Accept: text/markdown
  • JSON envelope for any Starcovery marketing page: append .json to the URL. The response is { "markdown": "...", "path": "/<page>", "source": "https://www.starcovery.com/<page>" }. The .json suffix rule excludes /openapi.json, which returns the OpenAPI document.
  • HTML responses set an x-agent-hint response header that points agents at the .md and .json page variants and the /agents and /openapi.json discovery endpoints.

On this page