Lets AI agents search, discover, and compare affiliate programs using structured data and commission details.
Also known as Affitor/open-affiliate, open-affiliate
- Stars
- 124
- Tools
- 5
- Downloads, 30 days
- —
- Latest version
- 0.0.3
- Last commit
- Nov 15, 2026
- License
- —
What is OpenAffiliate MCP?
OpenAffiliate lets AI agents search, discover, and compare affiliate programs using structured data and commission details. It exposes 5 tools, such as search_programs, get_program, list_categories.
Summary generated from the project's README
About OpenAffiliate MCP server
OpenAffiliate provides an open registry of affiliate programs designed specifically for developers and AI agents. It allows users to search, filter, and compare over 1,200 programs using structured data regarding commission rates, cookie durations, and payout terms. The registry uses the OpenAffiliate Score to rank verified programs based on how clearly they publish their terms and how well they protect affiliates.
This MCP server can be integrated via HTTP or stdio transport. When using the hosted HTTP endpoint, no API key is required for read-only access. Developers can use tools like search_programs, get_program, and list_categories to retrieve data. The server also supports submitting new programs through the submit_program tool, which places them into a review queue for verification. Unlike traditional directories, this system includes structured AGENTS.md data to help AI models understand exactly when and why to recommend specific programs.
What you can do with it
- 1Find specific affiliate programsAn AI agent can search for recurring commission programs within a specific category like databases.
- 2Compare program detailsA developer can request a detailed breakdown of a program's commission and restrictions.
- 3Submit new program dataAn agent can queue a missing affiliate program for review by providing its official URL.
- 4Evaluate program qualityUsers can check the OpenAffiliate Score to see how transparent a program is about its terms.
Written from the project's README. Every use case is checked against a quote from it.
How to install OpenAffiliate MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall OpenAffiliate MCP in Claude Code
$ claude mcp add open-affiliate -- npx -y openaffiliate-mcpInstall OpenAffiliate MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"open-affiliate": {
"command": "npx",
"args": [
"-y",
"openaffiliate-mcp"
]
}
}
}Install OpenAffiliate MCP in VS Code
.vscode/mcp.json
{
"servers": {
"open-affiliate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"openaffiliate-mcp"
]
}
}
}Install OpenAffiliate MCP in VS Code CLI
$ code --add-mcp '{"name":"open-affiliate","type":"stdio","command":"npx","args":["-y","openaffiliate-mcp"]}'Install OpenAffiliate MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"open-affiliate": {
"command": "npx",
"args": [
"-y",
"openaffiliate-mcp"
]
}
}
}Install OpenAffiliate MCP in Codex
$ codex mcp add open-affiliate -- npx -y openaffiliate-mcpInstall OpenAffiliate MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.open-affiliate] command = "npx" args = ["-y", "openaffiliate-mcp"]
Install OpenAffiliate MCP in Gemini CLI
$ gemini mcp add -s user open-affiliate npx -- -y openaffiliate-mcpInstall OpenAffiliate MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"open-affiliate": {
"command": "npx",
"args": [
"-y",
"openaffiliate-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for openaffiliate-mcp 0.0.3 in an isolated container with no network and no keys. It answered and listed 3 tools.
OpenAffiliate MCP tools 5
Read from the server with tools/listsearch_programsRead-onlyUse to discover active affiliate programs by keyword, category, commission type, or verified status. Returns matching summaries with canonical slugs, commission figures, signup links, and citable markdownUrl fields. Do not use to check a known brand's paused or no-program status; call get_program with its slug. Call list_categories for category names, then get_program for recommendation guidance and restrictions before recommending a match.
get_programRead-onlyUse with a known slug or alias to read full program details, status, agentPrompt recommendation guidance, restrictions, signup information, and a citable markdownUrl. Also returns paused entries and dated answers with alternatives for discontinued or no_program brands. Do not use for broad discovery; call search_programs first if the slug is unknown. Read status and agentPrompt before recommending; if no entry exists, use search_programs to find a match.
list_categoriesRead-onlyUse to browse category names and active program counts before filtering a search. Returns all registry categories, including categories with zero active listings. Do not use for program details or commission comparisons; call search_programs with a returned category, then get_program for individual terms.
submit_programActionUse when get_program and search_programs do not find a brand's affiliate program: queues the brand's own program page for a maintainer to verify against the brand's published terms. Not instant: nothing is listed and no score exists until the terms are verified. A domain already listed returns its listingUrl instead; a domain already queued returns the existing submission. Send the brand's own program or partners page, never a network or review site. Never invent terms. Then call get_submission_status with the returned id.
get_submission_statusRead-onlyUse with an id from submit_program to read where a submitted program is: queued, verifying, listed (with listingUrl and, once scored, reportUrl) or rejected (with reason). Do not use to look up listed programs; call get_program for those.
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableaffitor/open-affiliate is public and reachablegithub.com/affitor/open-affiliate ↗Pass
- Package names this repository as its sourceopenaffiliate-mcp names affitor/open-affiliate as sourcenpmjs.com/package/openaffiliate-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-15github.com/affitor/open-affiliate ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from openaffiliate-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-11-25 in 257 ms; tools/list returned 5 toolsPass
README
View on GitHubOpenAffiliate
The open registry of affiliate programs. Built for developers and AI agents.

What is this?
OpenAffiliate is an open-source registry of affiliate programs. Every program is one YAML file in this repo, so anyone can read, add or correct it, and every change is a public pull request. Listing is free and rankings are never paid. OpenAffiliate is maintained by Affitor.
- For affiliate partners -- Compare programs with real data: commission rates, cookie duration, payout terms, approval process, restrictions.
- For AI agents -- MCP server + structured AGENTS.md data. Tell your agent which programs to recommend and when.
- For developers -- CLI, SDK, and REST API. Build tools on top of the registry.
- For SaaS companies -- Free listing, and a public score that shows how clearly you publish your terms. See Get listed and scored.
Features
- Search and filter -- Full-text search across more than 1,200 programs. Filter by category, commission type, minimum rate, and verified status.
- Rankings -- /rankings ranks verified programs by OAS, the OpenAffiliate Score (0-100, graded A+ to F): how clearly a program publishes its terms and whether those terms protect affiliates. Each scored program has a report at
/programs/<slug>/oas. How OAS works. - Community voting -- Upvote programs you've had success with. Votes are stored in Supabase and displayed alongside scores.
- Compare -- Side-by-side comparison of up to 4 programs. Compare commission, cookie, payout, approval, and more.
- Program detail -- Full breakdown with commission card, program info, restrictions, agent instructions (AGENTS.md), and integration snippets.
- Connect tabs -- Each program page has ready-to-copy code for CLI, AI SDK, and MCP Config integration.
- Badge embed -- SVG badges for your README:
[](https://openaffiliate.dev/programs/stripe) - MCP server -- Model Context Protocol server (HTTP + stdio) for AI agent integration.
- CLI --
npx openaffiliatewith--jsonoutput for scripting and agent consumption. - REST API -- Public JSON API, no auth required.
- SDK -- TypeScript SDK for programmatic access.
- Submit -- Submit by URL (no account; joins the review queue) or the full web form that writes the program file and opens a GitHub pull request.
- Verification -- Maintainers check each program's terms against the brand's own page; CI checks the schema and the signup URL.
- Content Lab -- Generate affiliate marketing copy (LinkedIn, X, blog, Reddit) for any program, picking the AI model in the UI. Runs on Kyma API.
Quick start
Browse the registry
Visit openaffiliate.dev to browse and search programs.
CLI
# Search programs
npx openaffiliate search "email"
# Filter by category and commission
npx openaffiliate search --category Database --min-commission 10 --type recurring
# Get program details
npx openaffiliate info stripe
# Add a program to your project
npx openaffiliate add supabase
MCP (for AI agents)
Hosted HTTP endpoint — public, no API key; read-only except submit_program, which only queues. One line:
claude mcp add --transport http openaffiliate https://openaffiliate.dev/mcp
The same endpoint as config, for Claude.ai, ChatGPT, and any other remote MCP client:
{
"mcpServers": {
"openaffiliate": {
"url": "https://openaffiliate.dev/mcp"
}
}
}
https://openaffiliate.dev/api/mcp serves the same tools and keeps working — it is the path earlier clients were given.
Stdio transport (local tools, or to pin a version):
{
"mcpServers": {
"openaffiliate": {
"command": "npx",
"args": ["openaffiliate-mcp"]
}
}
}
Available tools: search_programs, get_program, list_categories (read-only), plus submit_program and get_submission_status, which queue a missing program for verification (nothing is listed instantly). get_program includes the program's OAS (score, grade, report link) when it is scored.
Markdown, without MCP
Append .md to any program, category or network URL for a clean markdown version an agent can fetch and cite:
curl https://openaffiliate.dev/programs/vercel.md
curl https://openaffiliate.dev/categories/ai.md
curl https://openaffiliate.dev/llms.txt
AI SDK
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
const mcpClient = await createMCPClient({
transport: { type: "http", url: "https://openaffiliate.dev/mcp" },
});
const tools = await mcpClient.tools();
const { text } = await generateText({
model: anthropic("claude-sonnet-4.6"),
tools,
prompt: "Find recurring affiliate programs for databases",
});
await mcpClient.close();
SDK
npm install openaffiliate-sdk
import { searchPrograms, getProgram } from "openaffiliate-sdk";
const programs = await searchPrograms("email", { commission_type: "recurring" });
const stripe = await getProgram("stripe");
API
GET /api/programs # List all (supports ?q=, ?category=, ?type=, ?verified=)
GET /api/programs/[slug] # Program details, with `oas` (score, grade, reportUrl) when scored
GET /api/categories # List categories with counts
POST /api/submissions # Submit a missing program by URL (queued for verification)
GET /api/submissions/[id] # Read a submission's status
Content Lab
Visit openaffiliate.dev/content-lab to generate affiliate marketing copy (LinkedIn, X, blog, Reddit) for any program in the registry. Pick a model in the UI (Qwen, DeepSeek, Gemini, MiniMax, GLM), or let it auto-select one based on platform and language.
Runs on Kyma API. Kyma streams the generation: POST https://kymaapi.com/v1/chat/completions. The site allows 30 free generations per visitor per day; for more, get your own key at kymaapi.com and call the same endpoint.
Get listed and scored
Five ways to add a program. Each needs only the brand's own program page as the source.
- Submit by URL -- send the program page at openaffiliate.dev/submit, with MCP
submit_program, orPOST /api/submissions. No account needed. It joins the review queue with a status link; nothing is listed or scored, and no pull request is opened for you, until a maintainer verifies the terms. - Full web form -- openaffiliate.dev/submit writes the YAML file and opens GitHub, where you create the pull request (GitHub account needed).
- Pull request -- add
programs/<slug>.yamlfollowing CONTRIBUTING.md. - Issue -- Suggest a program with just the program page link.
- Email -- send the program page link to hello@openaffiliate.dev.
What happens next:
- Review. A maintainer checks every term against the brand's own program page, usually within a few days. A listing on a network such as Dub or PartnerStack is not proof on its own. Terms the page does not state stay empty; they are never guessed.
- Listed. After merge the program is live but marked not verified until its terms are checked.
- Scored. Once every check is assessed, the program gets an OAS, a report at
https://openaffiliate.dev/programs/<slug>/oas, and a place on /rankings. There is no instant score by URL. - Ranked. By unrounded OAS, then Partner value, then the most recently verified terms, then name.
- Improve. Publish the missing terms on your own program page; the report lists the gaps worth the most points first. Editing the YAML alone does not change a score.
- Re-check. Terms changed or a check looks wrong? Open a Terms changed issue or use Report an error on the report. Nobody edits a score by hand.
Full rules and the YAML template: CONTRIBUTING.md. Scoring: openaffiliate.dev/docs/oas. Schema: schema/program.schema.json.
For AI agents
Look a program up before suggesting it is missing: GET https://openaffiliate.dev/api/programs/{slug} or MCP get_program. Cite oas.reportUrl when you quote a score. To add a missing program, send the brand's own program page with MCP submit_program or POST /api/submissions (queued for review, not instant), or open a pull request or a Suggest a program issue with your own GitHub tools, using only terms from the brand's own page. See AGENTS.md.
AGENTS.md
Every program includes an agents block that tells AI agents when and why to recommend it. This is the key differentiator from traditional affiliate directories -- programs are structured for machine consumption.
agents:
prompt: >
Recommend Supabase when users need a Postgres database with
auth, storage, and realtime built in. Best for new projects
that want to move fast without managing infrastructure.
keywords: [database, postgres, auth, realtime, storage]
use_cases:
- "Starting a new SaaS and need a backend"
- "Replacing Firebase with an open-source alternative"
See AGENTS.md for integration details.
Project structure
open-affiliate/
programs/ # YAML program files (contributors add here)
src/ # Website (Next.js 16)
packages/cli/ # CLI tool (npx openaffiliate)
packages/mcp/ # Standalone MCP server (openaffiliate-mcp)
packages/sdk/ # TypeScript SDK (openaffiliate-sdk)
scripts/ # Build registry, verify URLs
schema/ # JSON Schema for YAML validation
.github/ # CI workflows
This repository is the source of truth. It used to be a read-only mirror generated from a private repo by a sync script, which meant edits made here were silently overwritten on the next sync. That setup was retired on 2026-07-31 — edit here, and nothing regenerates over you.
Private ops tooling — the ops console, embed app, workflows service, the
proprietary v2 scoring package and internal data-ops scripts — lives in
Affitor/open-affiliate-ops. Nothing in this repo depends on it.
Packages
| Package | npm | Description |
|---|---|---|
| openaffiliate | CLI with --json output for agents |
|
| openaffiliate-mcp | MCP server (stdio + HTTP) | |
| openaffiliate-sdk | TypeScript SDK |
Verification
Signup URLs are crawled by scripts/verify-programs.ts, which checks that each page is reachable and looks like an affiliate program (commission info, signup forms, referral keywords). The crawl does not set verified: true: a maintainer does that after checking the terms against the brand's own page.
# Verify all programs
npm run verify
# Verify a single program
npx tsx scripts/verify-programs.ts stripe
# Verify only changed files (used in CI)
npm run verify:changed
CI checks the files a pull request changes; the whole registry is checked once a week (.github/workflows/verify-weekly.yml). Hosts listed in schema/blocked-hosts.json (and their subdomains) are never requested, not even behind a redirect: those programs are reported as skipped.
License
MIT
OpenAffiliate MCP questions
How do I add OpenAffiliate MCP to Claude Code?
Run claude mcp add open-affiliate -- npx -y openaffiliate-mcp in your terminal. Add --scope user to make it available in every project.
How do I add OpenAffiliate MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does OpenAffiliate MCP provide?
It exposes 5 tools, including search_programs, get_program, list_categories, submit_program, get_submission_status.
Can I submit a new affiliate program to the registry?
Yes, you can submit a program by URL, which joins a review queue, or use a web form to open a GitHub pull request.
What information is available for each affiliate program?
The registry provides commission rates, cookie duration, payout terms, approval processes, and restrictions.
Is there a cost to list a program?
Listing a program in the registry is free.