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 Claude
Add the MCP server with one command:
claude mcp add --transport http affiliateos https://api.affiliateos.dev/mcpThe first tool call opens a sign-in popup (OAuth 2.1 with PKCE), so no API keys end up in your agent config. Prefer 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. Agents can call connect_network_instructions to hand you the right link, but they never see or submit secrets.
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 16 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 |