Start
Quickstart
AffiliateOS connects your own affiliate network accounts (Awin, Impact, CJ, Rakuten, Amazon) and exposes them to agents through an MCP server and a REST API. This page gets you from zero to a tracked link and an earnings readout.
What you need
Existing affiliate network accounts. AffiliateOS is BYOC (bring your own credentials): it works with the API credentials of accounts you already have, and it can’t apply to networks or programs for you.
https://app.affiliateos.dev, the API and MCP server at https://api.affiliateos.dev, and these docs are part of the marketing site.1. Connect your assistant
In Claude or ChatGPT, open Settings → Connectors, add a custom connector, and paste this URL:
https://api.affiliateos.dev/mcpSigning in through the popup that appears (OAuth 2.1 with PKCE) is the whole setup — no terminal and no API keys. The connect guide has the click-by-click for each app, including Codex and other MCP clients.
From a terminal, the equivalent one-liner is:
claude mcp add --transport http affiliateos https://api.affiliateos.dev/mcpPrefer keys or a non-MCP stack? See the REST API.
2. Connect your networks
Credentials are entered once, by you, in the dashboard at https://app.affiliateos.dev/onboarding. Each network’s form tells you exactly where to find every value; the network guides have the same walkthroughs. An agent can start the connection for you — start_network_connection returns a link that opens the form already set up for the right network, and the agent is told when you finish — but the credential goes from your browser into the vault and is never visible to it. Nothing an agent holds can submit a secret or read one back.
Credentials are verified against the network on submit, sealed with libsodium before storage, and decrypted only in worker memory at call time.
3. Run the loop
Ask your agent to find something to promote and measure it:
| Step | Tool | What happens |
|---|---|---|
| Discover | search_programs | Searches programs across every connected network, ranked and filtered. |
| Mint | create_link | Turns a product URL into a tracked link on your own account, stamped with an attribution tag. |
| Learn | get_earnings_summary | Reads earnings grouped by tag, so the agent sees what each placement earned. |
A realistic first prompt: “Find a trail-running program I’m approved for, create a link to this shoe under the tag yt-desc-review, and check what that tag has earned this month.”
Where to go next
| Page | Covers |
|---|---|
| MCP server | All 21 tools, auth, and response conventions |
| REST API | Endpoints, API keys, rate limits, errors |
| Attribution tags | How sub-ID tracking works across networks |
| Webhooks | Signed event delivery and verification |
| Disclosure & ToS | Staying compliant while agents place links |