Koddeo

Working

com.koddeo/koddeov1.0.0 Domain verified

Find community referral codes for 200+ brands, and publish, refresh or boost your own.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://koddeo.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

boost_code

Create a Stripe checkout to pin one of the user's codes to the top of its brand page. Prices: 48h €0.79, 1 week €1.49, 3 weeks €2.99. Returns a payment link the user must open to pay; the Boost starts as soon as payment succeeds.

code_idstring, required

Code id from list_my_codes

durationstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

boost_code

Argument	Type	Description
code_id*	string	Code id from list_my_codes
duration	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "code_id"
  ],
  "properties": {
    "code_id": {
      "type": "string",
      "minLength": 1,
      "description": "Code id from list_my_codes"
    },
    "duration": {
      "enum": [
        "HOURS_48",
        "WEEK_1",
        "WEEKS_3"
      ],
      "type": "string",
      "default": "WEEK_1"
    }
  }
}

get_company_codes

List the active community referral codes for one brand, in the same order as on its Koddeo page (boosted and Premium codes first).

read-only

Argument	Type	Description
slug*	string	Company slug from search_companies, e.g. 'revolut'
limit	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Company slug from search_companies, e.g. 'revolut'"
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1
    }
  }
}

get_my_account

The connected user's plan, daily refresh quota and number of published codes.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_my_codes

The connected user's referral codes with views, clicks and Boost status.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

publish_code

Publish one of the user's referral codes on a brand page. One code per brand per user. Provide a code, a referral link, or both.

Argument	Type	Description
code	string	The referral code itself
link	string	The referral link
title*	string	Short pitch, e.g. '€20 bonus on your first deposit'
description	string	Conditions, how to use it
company_slug*	string	Company slug from search_companies

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "company_slug",
    "title"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 100,
      "description": "The referral code itself"
    },
    "link": {
      "type": "string",
      "format": "uri",
      "description": "The referral link"
    },
    "title": {
      "type": "string",
      "maxLength": 120,
      "minLength": 3,
      "description": "Short pitch, e.g. '€20 bonus on your first deposit'"
    },
    "description": {
      "type": "string",
      "maxLength": 1000,
      "description": "Conditions, how to use it"
    },
    "company_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Company slug from search_companies"
    }
  }
}

refresh_all_codes

Bump every active code of the user at once. Free accounts get 1 per day (Paris time); Premium is unlimited.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

refresh_code

Bump one of the user's codes back up its brand page ranking.

Argument	Type	Description
code_id*	string	Code id from list_my_codes

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "code_id"
  ],
  "properties": {
    "code_id": {
      "type": "string",
      "minLength": 1,
      "description": "Code id from list_my_codes"
    }
  }
}

search_companies

Search the brands listed on Koddeo (banks, crypto, delivery, VPN, e-commerce...) that have community referral codes. Returns each brand's slug, to use with get_company_codes or publish_code.

read-only

Argument	Type	Description
limit	integer
query*	string	Brand name or keyword, e.g. 'revolut' or 'vpn'

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 8,
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Brand name or keyword, e.g. 'revolut' or 'vpn'"
    }
  }
}

subscribe_premium

Create a Stripe checkout for Koddeo Premium (automatic refresh, Premium badge, priority ranking): €5.99/month or €47.88/year. Returns a link the user must open to pay. If already subscribed, returns the billing portal.

Argument	Type	Description
plan	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "plan": {
      "enum": [
        "MONTHLY",
        "YEARLY"
      ],
      "type": "string",
      "default": "YEARLY"
    }
  }
}