Docs
affiliatespy.io ↗
Get started

Quickstart

Three steps from zero to your agent reading your creator roster. Works with any client that speaks Streamable HTTP.

1 · Sign in through your client, or create an API key

Clients that support OAuth (Claude, ChatGPT, Claude Code, Cursor, Codex) only need the endpoint URL: add it, and the client opens the AffiliateSpy sign-in page (sign up there if you are new) followed by a consent screen. Nothing to copy. For scripts, or clients that only take headers, go to Settings → API & agents and create a key. Keys look like asp_live_… and can be revoked at any time — revoked keys stop working immediately.

2 · Add the server to your client

The server is remote — nothing to install or run. Point your client at the endpoint with your key in the Authorization header:

Endpoint  https://affiliatespy.io/api/mcp
Header    Authorization: Bearer asp_live_YOUR_KEY

Client-specific setup: Claude, Claude Code, Cursor. Any other MCP client that supports a URL plus headers uses the same shape as Cursor.

3 · Ask your agent something

A good first prompt:

List my top-graded creators without an email revealed yet.

The agent will call list_apps then list_creators and reason over the result. See the tool reference for everything it can reach.

Limits & guarantees

  • 60 requests per minute per API key.
  • Endpoint: https://affiliatespy.io/api/mcp — stateless Streamable HTTP, 2025 and 2026 protocol revisions.
  • Plan caps, the monthly reveal meter and contact sanitization are enforced server-side — the MCP surface can never exceed what your dashboard allows.
  • Guarded actions (launch, pause, resume, send, scan, autopilot) first return approval_required with a summary and a token; the agent shows the summary, you say yes, it calls again with the token. Skip approvals per account with Unrestricted MCP in Settings → API & agents.
  • Before a plan: start_quick_scan, get_quick_scan_preview and get_checkout_link work; everything else returns no_subscription.
  • Prefer REST? Every tool is also POST /api/v1/tools/{name} with the same header; the OpenAPI document is /openapi.json and this page is available as markdown at /docs/quickstart.md.