Koddeo MCP

An MCP server enabling AI agents to search for community referral codes, retrieve company-specific offers, and manage user accounts including publishing, refreshing, and boosting referral codes via a personal API key.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Koddeo

You need:personal API key (created at https://koddeo.com/dashboard/agents)

MCP endpoint (Streamable HTTP)

https://koddeo.com/api/mcp

Vendor documentation

What you can do with it

Search for companies offering referral codes
Retrieve active referral codes for a specific company
Publish a new referral code to the marketplace
Boost or refresh existing referral codes

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: com.koddeo/koddeo@1.0.0 Project website

Protocol and capabilities

Server: koddeo 1.0.0
MCP protocol: 2025-06-18
Tools: 9 advertised
Resources: 1 advertised
Resource templates: 0 advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Koddeo is a community marketplace for referral codes. Use search_companies then get_company_codes to find codes. With the user's API key you can publish, refresh and boost their codes, or start a Premium subscription. Payments always return a Stripe link the user must open themselves.

Tools

9 advertised

search_companies — Search companies

Advertised by the server during the last successful anonymous check.

Advertised read-only

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.

search_companies input schema

{
  "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'"
    }
  }
}

search_companies annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

get_company_codes — Get a company's referral codes

Advertised by the server during the last successful anonymous check.

Advertised read-only

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

get_company_codes input schema

{
  "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_company_codes annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

get_my_account — Get my Koddeo account

Advertised by the server during the last successful anonymous check.

Advertised read-only

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

get_my_account input schema

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

get_my_account annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

list_my_codes — List my codes

Advertised by the server during the last successful anonymous check.

Advertised read-only

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

list_my_codes input schema

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

list_my_codes annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

publish_code — Publish a referral code

Advertised by the server during the last successful anonymous check.

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.

publish_code input schema

{
  "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"
    }
  }
}

publish_code annotations

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

refresh_code — Refresh a code

Advertised by the server during the last successful anonymous check.

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

refresh_code input schema

{
  "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"
    }
  }
}

refresh_code annotations

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

refresh_all_codes — Refresh all my codes

Advertised by the server during the last successful anonymous check.

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

refresh_all_codes input schema

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

refresh_all_codes annotations

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

boost_code — Boost a code

Advertised by the server during the last successful anonymous check.

Open-world

Create a Stripe checkout to pin one of the user's codes to the top of its brand page. Price depends on the brand category: standard 48h €0.79 / 1 week €1.49 / 3 weeks €2.99; telecom, energy, VPN, SaaS and insurance €0.99 / €1.79 / €3.49; finance and betting €1.19 / €2.29 / €3.99. Returns a payment link the user must open to pay; the Boost starts as soon as payment succeeds.

boost_code input schema

{
  "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"
    }
  }
}

boost_code annotations

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

subscribe_premium — Subscribe to Premium

Advertised by the server during the last successful anonymous check.

Open-world

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

subscribe_premium input schema

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

subscribe_premium annotations

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

codes-widget — Koddeo codes card

Advertised by the server during the last successful anonymous check.

codes-widget URI

ui://koddeo/codes-v1.html

MIME type: text/html;profile=mcp-app

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 1017 ms
95th percentile latency: 1017 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 7:50 AM UTC · probe · passed · 1017 ms · metadata changed · 9 tool(s), 1 resource(s), 0 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http koddeo-mcp https://koddeo.com/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add koddeo-mcp --url https://koddeo.com/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable koddeo-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "koddeo-mcp": {
      "url": "https://koddeo.com/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "koddeo-mcp": {
      "type": "streamableHttp",
      "url": "https://koddeo.com/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start koddeo-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "koddeo-mcp": {
      "type": "http",
      "url": "https://koddeo.com/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http koddeo-mcp https://koddeo.com/api/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "koddeo-mcp": {
      "url": "https://koddeo.com/api/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "koddeo-mcp": {
      "serverUrl": "https://koddeo.com/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Koddeo MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 1,113

Do you run Koddeo MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

Koddeo MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other commerce servers

Do you run Koddeo MCP?