io.github.sonpiaz/openaffiliate-mcp MCP Server

OpenAffiliate

The open registry of affiliate programs. Built for developers and AI agents.

What is this?

OpenAffiliate is a community-driven, open-source registry of affiliate programs. Every program is stored as a YAML file in this repo, making it easy to contribute, review, and integrate.

• 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 in a canonical registry. Exposure to developer partners and AI agents.

Features

• Search and filter -- Full-text search across 349+ programs. Filter by category, commission type, minimum rate, and verified status.
• Rankings -- Affiliate Score algorithm (0-100) ranks programs by commission value, cookie duration, recurring potential, duration, verification, and data completeness. Sort by score, name, commission, or cookie days. View rankings by programs, networks, or categories.
• 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: [![OpenAffiliate](https://openaffiliate.dev/badge/stripe.svg)](https://openaffiliate.dev/programs/slab)
• MCP server -- Model Context Protocol server (HTTP + stdio) for AI agent integration.
• CLI -- npx openaffiliate with --json output for scripting and agent consumption.
• REST API -- Public JSON API, no auth required.
• SDK -- TypeScript SDK for programmatic access.
• Submit -- Web form to submit new programs without touching YAML.
• Verification -- Automated signup URL verification via CI.
• 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)

HTTP endpoint (Claude.ai, ChatGPT, any MCP client):

{
  "mcpServers": {
    "openaffiliate": {
      "url": "https://openaffiliate.dev/api/mcp"
    }
  }
}

Stdio transport (Claude Code, Cursor, local tools):

{
  "mcpServers": {
    "openaffiliate": {
      "command": "npx",
      "args": ["openaffiliate-mcp"]
    }
  }
}

Available tools: search_programs, get_program, list_categories

AI SDK

import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";

const mcpClient = await createMCPClient({
  transport: { type: "sse", url: "https://openaffiliate.dev/api/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]       # Get program details
GET /api/categories            # List categories with counts

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.

Contributing a program

1. Fork this repo
2. Create a YAML file in programs/your-product.yaml
3. Open a pull request
4. CI validates the schema and verifies your signup URL automatically
5. Community reviews and merges

Program YAML format

name: Your Product
slug: your-product
url: https://yourproduct.com
category: Developer Tools
tags: [keyword1, keyword2]

commission:
  type: recurring
  rate: "25%"
  currency: USD
  duration: "12 months"

cookie_days: 30
signup_url: https://yourproduct.com/affiliates
approval: auto
approval_time: "instant"

payout:
  minimum: 50
  currency: USD
  frequency: monthly
  methods: [bank, paypal]

description: >
  What your product does and what the affiliate program offers.
short_description: "One-line description"

agents:
  prompt: >
    When AI agents should recommend this product.
  keywords: [keyword1, keyword2]
  use_cases:
    - "When a user needs X"

verified: false
submitted_by: "@your-github"

See schema/program.schema.json for the full specification and openaffiliate.dev/docs for complete documentation.

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
  packages/scoring/    # Affiliate Score v1 — the public formula
  .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

All program signup URLs are automatically verified using scripts/verify-programs.ts. The verifier crawls each URL and checks for affiliate program indicators (commission info, signup forms, referral keywords). Programs that pass verification are marked verified: true.

# 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

License

MIT

GitHub