cdk-mcp

CDK Bot: search the catalog of digital products (game keys, gift cards, DLC) by title, platform, device, region, or language. Returns a best match with alternatives (smart matching). Use browse_filters first to see valid filter values.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Game title or search keywords (e.g. \"GTA V\", \"Elden Ring\")"
    },
    "platform": {
      "type": "string",
      "description": "Platform/storefront filter (e.g. Steam, PSN, Xbox Live)"
    },
    "device": {
      "type": "string",
      "description": "Target device filter (e.g. PC, PS5, Xbox Series X|S)"
    },
    "region": {
      "type": "string",
      "description": "Region filter (e.g. WORLDWIDE, EUROPE)"
    },
    "language": {
      "type": "string",
      "description": "Language filter (ISO 639-1 code like \"en\", \"pl\", or \"multilanguage\")"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: get detailed information about a specific digital product (game key, gift card, DLC) including price, activation instructions, and delivery time. Use the game_id from search_games results.

{
  "type": "object",
  "properties": {
    "game_id": {
      "type": "string",
      "description": "Game ID (UUID) from search results"
    }
  },
  "required": [
    "game_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: list all available platforms, devices, regions, and languages for filtering digital product searches. Call this first to know what filter values are valid.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: lock the current price for a digital product and get USDC payment instructions. Returns a quote_id valid for 5 minutes. After paying, use confirm_purchase with the tx_hash and quote_id.

{
  "type": "object",
  "properties": {
    "game_id": {
      "type": "string",
      "description": "Game ID to get a price quote for"
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "base-sepolia"
      ],
      "description": "Payment chain. Use \"base-sepolia\" for sandbox testing with mock keys."
    }
  },
  "required": [
    "game_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: receive the product key after paying. Two ways to pay: (1) one-shot — pass x_payment, a signed EIP-3009 "exact" X-PAYMENT header (from accepts[] in get_price_quote); the facilitator settles it gaslessly, no tx_hash needed. (2) two-step — send USDC yourself, then pass tx_hash + quote_id.

{
  "type": "object",
  "properties": {
    "game_id": {
      "type": "string",
      "description": "Game ID being purchased"
    },
    "tx_hash": {
      "type": "string",
      "description": "Two-step flow: the USDC payment transaction hash on Base. Provide this OR x_payment."
    },
    "quote_id": {
      "type": "string",
      "description": "Required WITH tx_hash — locks the quoted price and prevents front-running. Not needed with x_payment."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "base-sepolia"
      ],
      "description": "Payment chain (default: \"base\")"
    },
    "x_payment": {
      "type": "string",
      "description": "One-shot flow: a base64-encoded EIP-3009 \"exact\" X-PAYMENT payload signed by the buyer wallet for accepts[0] from get_price_quote. Settles gaslessly via the facilitator — no tx_hash/quote_id needed."
    }
  },
  "required": [
    "game_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: check the status of a purchase order. Provide wallet_address to retrieve the product key. Pending orders are automatically polled for fulfillment.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Order ID (UUID) from a previous purchase"
    },
    "wallet_address": {
      "type": "string",
      "description": "Buyer wallet address. Required to retrieve the product key."
    }
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: submit a refund claim for a purchased product key. Must be within 30 days of purchase. Delivery failures (not_delivered) are auto-approved instantly. Key issues are verified within 24 hours.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Order ID to refund"
    },
    "wallet_address": {
      "type": "string",
      "description": "Buyer wallet address (must match the order)"
    },
    "reason": {
      "type": "string",
      "enum": [
        "key_invalid",
        "key_already_redeemed",
        "wrong_product",
        "not_delivered"
      ],
      "description": "Reason: key_invalid (activation error), key_already_redeemed (used before delivery), wrong_product (wrong platform/region/edition), not_delivered (payment confirmed but no key received)"
    }
  },
  "required": [
    "order_id",
    "wallet_address",
    "reason"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

CDK Bot: rate a completed purchase (1-5 stars). Helps improve the service. One review per order. Requires order_id and the wallet_address used for payment.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Order ID to review"
    },
    "wallet_address": {
      "type": "string",
      "description": "Buyer wallet address (must match the order)"
    },
    "rating": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Rating from 1 (poor) to 5 (excellent)"
    },
    "comment": {
      "type": "string",
      "description": "Optional comment about the purchase experience"
    },
    "agent_name": {
      "type": "string",
      "description": "Your agent/client name (e.g. \"Claude Desktop\", \"Cursor\")"
    }
  },
  "required": [
    "order_id",
    "wallet_address",
    "rating"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}