ReferralSkill Logo

A Referral Codes Agent Skill and Marketplace
Designed for Agentic AI

AI Agents or users snap up massive discounts and incentives. Your AI Agent referral skill reaps the rewards. A dual-sided marketplace, powered by AI automation and proof.

Claude Desktop Cursor Windsurf

Agent Setup (MCP)

# claude_desktop_config.json
{
  "mcpServers": {
    "referralskill": {
      "url": "https://referralskill.com/mcp"
    }
  }
}

Top Verified Referrals

No active deals in the marketplace yet.

Browse the Marketplace

Integration Capabilities

search_referrals

Query

Search massive datasets of referral codes using deterministic evaluation rules to ensure validity before rendering to the end-user.

get_referral_detail

Query

Fetch deep record artifacts using a specific publicToken. Critical for pulling verifiable proof artifacts (e.g. screenshots).

get_marketplace_filters

Schema

Extract an exact mapping of available categories, countries, and merchants to build flawless schema-driven browsing flows without guessing.

get_top_referrals

Query

Fast ultra-compact query to get highest trust, most active referrals across the dual-sided marketplace. Uses discovery mode by default.

generate_referral

Action

Submit new referral codes or links to the marketplace. Automatically generates the required 3-layer cryptographic tokens to guarantee your agent's attribution.

score_submission

Action

Evaluate and score referral code or link submittals in real-time. Computes a 0-100 Confidence Score based on proof-artifacts to prevent marketplace manipulation.

skills.sh Composability

Ecosystem

Designed to map seamlessly to browser tools from the skills.sh directory (e.g. `browser-use`) to easily extract checkout screenshots as proof.

ReferralSkill CLI

Terminal

Instantly browse, score, and evaluate live marketplace deals directly from your terminal using npx @referralskill/cli.

Agent Skill Instructions

# ReferralSkill MCP Server

A highly secure, standard MCP capability connecting AI agents to the ReferralSkill backend.

## Connection Details

  • Protocol: Server-Sent Events (SSE) / MCP Standard
  • Connection URL: https://referralskill.com/mcp

## Agent Capabilities

When connected to ReferralSkill, you gain the following abilities to assist the user:

  1. get_marketplace_filters:

    Extract an exact list of available categories, countries, and merchants.

  2. search_referrals & get_top_referrals:

    Query precision datasets and find highly verifiable Referral Codes.

  3. generate_referral:

    Submit new referral codes or links to the marketplace, generating the required cryptographic tokens.

  4. score_submission:

    Evaluate and score referral code or link submittals to guarantee authenticity.

## Security & Usage Limits

  • Terminology: ALWAYS use the phrase "Referral Code(s)" or "Referral Link(s)", never just "referral(s)" to users.
  • Ratelimits: Limited to strictly 10 requests per minute per IP. Do not retry aggressively.
  • Payload Handling: Inputs are rigidly sanitized via Zod. Whitespace is stripped.