{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.comidoc.com",
    "site": "comidoc.com",
    "addresses": [
      {
        "address": "51.68.225.29",
        "endpoints": 2,
        "shared_infrastructure": false,
        "network": {
          "asn": 16276,
          "prefix": "51.68.0.0/16",
          "country": "FR",
          "name": "OVH - OVH SAS"
        }
      },
      {
        "address": "2001:41d0:305:2100::8cf7",
        "endpoints": 2,
        "shared_infrastructure": false,
        "network": {
          "asn": 16276,
          "prefix": "2001:41d0::/32",
          "country": "FR",
          "name": "OVH - OVH SAS"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "51.68.225.29",
          "2001:41d0:305:2100::8cf7"
        ],
        "first_seen": "2026-11-21T20:43:01.785Z",
        "last_seen": "2026-11-21T20:43:01.785Z",
        "checks": 1
      }
    ],
    "hosting": [],
    "software": [
      {
        "value": "nginx",
        "evidence": "Server header \"nginx\""
      }
    ],
    "server_info": {
      "name": "comidoc-course-discovery",
      "version": "1.1.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "nginx",
      "strict-transport-security": "max-age=31536000",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 1,
      "sample": [
        {
          "id": "45779",
          "url": "https://mcp.extension.report/",
          "server_name": "report.extension/extension-report",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T19:26:02.619Z"
        }
      ]
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.comidoc",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "50805",
    "server_name": "com.comidoc/comidoc",
    "url": "https://mcp.comidoc.com/",
    "host": "mcp.comidoc.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T20:43:01.785Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "7e34f99a0f1dfdcfd934136994ebf6d74a47713a75876b815f27b21cf9a5f043",
    "first_listed_at": "2026-11-21T20:43:01.785Z",
    "created_at": "2026-11-21T16:25:02.590Z",
    "resolved_addresses": [
      "51.68.225.29",
      "2001:41d0:305:2100::8cf7"
    ]
  },
  "server": {
    "name": "com.comidoc/comidoc",
    "title": "Comidoc",
    "description": "Verified Udemy coupons, courses, topics and trends. Premium opens coupons in your browser (OAuth).",
    "version": "1.2.0",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://comidoc.com/ai-agents",
    "published_at": "2026-11-22T14:56:32.155Z",
    "updated_at": "2026-11-22T14:56:32.155Z",
    "first_seen": "2026-11-21T16:25:01.343Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T16:11:35.238Z"
  },
  "operator": {
    "key": "comidoc.com",
    "name": "comidoc.com",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1010,
    "first_check_in_window": "2026-11-21T20:43:01.785Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "7e34f99a0f1dfdcfd934136994ebf6d74a47713a75876b815f27b21cf9a5f043",
    "tools": 11,
    "resources": 1,
    "prompts": 1,
    "first_seen": "2026-11-21T20:43:02.798Z",
    "tool_names": [
      "search_courses",
      "fetch_course",
      "find_offers",
      "get_filter_options",
      "list_topics",
      "fetch_topic",
      "get_trending_courses",
      "get_trending_topics",
      "show_course_cards",
      "get_my_access",
      "submit_coupons"
    ],
    "declared": {
      "tools": [
        {
          "name": "search_courses",
          "title": "Search courses",
          "description": "Search the Comidoc historical course catalog with topic, quality, freshness, coupon availability, repeat-course, and regular-issuer filters. Coupon capacity and remaining redemptions are always returned when known. Courses with an active coupon carry an access block (Premium requirement, savings, Premium price and checkout link, recommendation). Open course_url in the person's browser signed in to comidoc.com, never a coupon code (server instructions).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "sort": {
                "enum": [
                  "newest",
                  "updated",
                  "rating",
                  "popular",
                  "trending",
                  "duration",
                  "price"
                ],
                "type": "string",
                "default": "updated"
              },
              "level": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 80,
                    "minLength": 1
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 10,
                    "minItems": 1
                  }
                ],
                "description": "One or more canonical get_filter_options values: Beginner, Intermediate, Expert, or All Levels. Matching ignores case; unknown values are rejected."
              },
              "limit": {
                "type": "integer",
                "default": 10,
                "maximum": 10,
                "minimum": 1,
                "description": "Results per page. This connection returns at most 10. Page sizes: anonymous 10, signed-in Comidoc account or free API key 25, API Pro key 100. A larger value is reduced to 10 and meta.limit_note says so; fetch the next page with pagination.next_cursor."
              },
              "query": {
                "type": "string",
                "maxLength": 120,
                "description": "Words in the title, description, or instructor name."
              },
              "topic": {
                "type": "string",
                "maxLength": 120,
                "description": "Comidoc topic slug, for example python."
              },
              "cursor": {
                "type": "string",
                "maxLength": 500
              },
              "rating": {
                "anyOf": [
                  {
                    "enum": [
                      "lt-4",
                      "gte-4-lt-4_5",
                      "gte-4_5"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "lt-4",
                        "gte-4-lt-4_5",
                        "gte-4_5"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "minItems": 1
                  }
                ]
              },
              "horizon": {
                "enum": [
                  "24h",
                  "7d",
                  "30d"
                ],
                "type": "string",
                "default": "7d"
              },
              "category": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 120,
                    "minLength": 1
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 120,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "minItems": 1
                  }
                ],
                "description": "One or more canonical get_filter_options values. Matching ignores case; unknown values are rejected."
              },
              "duration": {
                "anyOf": [
                  {
                    "enum": [
                      "short",
                      "medium",
                      "long"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "short",
                        "medium",
                        "long"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "minItems": 1
                  }
                ]
              },
              "language": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 80,
                    "minLength": 1
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "minItems": 1
                  }
                ],
                "description": "One or more canonical get_filter_options values. Matching ignores case; unknown values are rejected."
              },
              "course_id": {
                "type": "integer",
                "description": "Udemy's numeric course ID.",
                "exclusiveMinimum": 0
              },
              "coupon_age": {
                "anyOf": [
                  {
                    "enum": [
                      "24h"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "24h"
                      ],
                      "type": "string"
                    },
                    "maxItems": 1,
                    "minItems": 1
                  }
                ]
              },
              "course_slug": {
                "type": "string",
                "maxLength": 200
              },
              "course_type": {
                "anyOf": [
                  {
                    "enum": [
                      "courses",
                      "tests"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "courses",
                        "tests"
                      ],
                      "type": "string"
                    },
                    "maxItems": 2,
                    "minItems": 1
                  }
                ]
              },
              "coupon_status": {
                "anyOf": [
                  {
                    "enum": [
                      "active",
                      "expired",
                      "invalid",
                      "pending_verification",
                      "all"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "active",
                        "expired",
                        "invalid",
                        "pending_verification",
                        "all"
                      ],
                      "type": "string"
                    },
                    "maxItems": 5,
                    "minItems": 1
                  }
                ]
              },
              "discount_type": {
                "anyOf": [
                  {
                    "enum": [
                      "free",
                      "percentage"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "free",
                        "percentage"
                      ],
                      "type": "string"
                    },
                    "maxItems": 2,
                    "minItems": 1
                  }
                ]
              },
              "expires_after": {
                "type": "string",
                "format": "date-time"
              },
              "expires_before": {
                "type": "string",
                "format": "date-time"
              },
              "maximum_rating": {
                "type": "number",
                "maximum": 5,
                "minimum": 0
              },
              "minimum_rating": {
                "type": "number",
                "maximum": 5,
                "minimum": 0
              },
              "published_after": {
                "type": "string",
                "format": "date-time"
              },
              "has_active_coupon": {
                "type": "boolean"
              },
              "coupon_created_after": {
                "type": "string",
                "format": "date-time"
              },
              "repeat_coupon_course": {
                "enum": [
                  "include",
                  "exclude",
                  "only"
                ],
                "type": "string",
                "default": "include"
              },
              "regular_coupon_issuer": {
                "enum": [
                  "include",
                  "exclude",
                  "only"
                ],
                "type": "string",
                "default": "include"
              },
              "last_course_updated_after": {
                "type": "string",
                "format": "date-time",
                "description": "Filters the last update published by Udemy, not Comidoc's technical record update."
              },
              "minimum_remaining_redemptions": {
                "type": "integer",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "data",
              "pagination",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "slug",
                    "title",
                    "description",
                    "thumbnail_url",
                    "course_url",
                    "instructor",
                    "category",
                    "subcategory",
                    "language",
                    "level",
                    "rating",
                    "reviews",
                    "students",
                    "duration_minutes",
                    "is_practice_test",
                    "is_free",
                    "original_price",
                    "published_at",
                    "record_updated_at",
                    "last_course_update_at",
                    "topics",
                    "coupon_history",
                    "offer_count",
                    "returned_offer_count",
                    "active_offer_count",
                    "offers_truncated",
                    "offers"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer",
                      "description": "Udemy's canonical numeric course ID."
                    },
                    "slug": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "level": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "title": {
                      "type": "string"
                    },
                    "access": {
                      "type": "object",
                      "required": [
                        "requires",
                        "price",
                        "price_with_coupon",
                        "savings",
                        "currency",
                        "topic_last_30_days",
                        "recommendation",
                        "reason"
                      ],
                      "properties": {
                        "price": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "reason": {
                          "enum": [
                            "free_course",
                            "savings_cover_premium",
                            "topic_history",
                            "savings_below_premium",
                            "price_unknown",
                            "premium_unavailable",
                            "premium_active",
                            "premium_credits"
                          ],
                          "type": "string"
                        },
                        "granted": {
                          "type": "boolean",
                          "const": true,
                          "description": "Present when the connected person has Premium: nothing to buy, follow how_to_open."
                        },
                        "premium": {
                          "type": "object",
                          "required": [
                            "id",
                            "price",
                            "currency",
                            "renews",
                            "checkout_url",
                            "period",
                            "cancel_anytime"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "const": "premium_monthly"
                            },
                            "price": {
                              "type": "number"
                            },
                            "period": {
                              "type": "string",
                              "const": "month"
                            },
                            "renews": {
                              "type": "boolean"
                            },
                            "currency": {
                              "type": "string",
                              "const": "USD"
                            },
                            "alternatives": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "required": [
                                  "id",
                                  "price",
                                  "currency",
                                  "renews",
                                  "checkout_url",
                                  "period"
                                ],
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "const": "premium_seven_days"
                                  },
                                  "price": {
                                    "type": "number"
                                  },
                                  "period": {
                                    "type": "string",
                                    "const": "7_days"
                                  },
                                  "renews": {
                                    "type": "boolean"
                                  },
                                  "currency": {
                                    "type": "string",
                                    "const": "USD"
                                  },
                                  "checkout_url": {
                                    "type": "string",
                                    "format": "uri",
                                    "description": "The person opens it to pay; never pay for them."
                                  }
                                }
                              }
                            },
                            "checkout_url": {
                              "type": "string",
                              "format": "uri",
                              "description": "The person opens it to pay; never pay for them."
                            },
                            "regular_price": {
                              "type": "number",
                              "description": "Price after the current promotion ends."
                            },
                            "cancel_anytime": {
                              "type": "boolean",
                              "const": true
                            },
                            "promotion_ends_at": {
                              "type": "string",
                              "format": "date-time"
                            }
                          },
                          "description": "The Premium plan currently sold. Quote these values; never invent a price."
                        },
                        "savings": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "currency": {
                          "type": "string",
                          "const": "USD"
                        },
                        "requires": {
                          "enum": [
                            "premium",
                            "none"
                          ],
                          "type": "string",
                          "description": "premium: the active coupon is a Comidoc Premium benefit. none: the course is free on Udemy without a coupon."
                        },
                        "how_to_open": {
                          "type": "string",
                          "description": "With granted: how to open the coupon for the person. Follow it."
                        },
                        "recommendation": {
                          "enum": [
                            "worth_it",
                            "optional",
                            "not_needed"
                          ],
                          "type": "string",
                          "description": "worth_it: savings cover Premium, or topic_last_30_days shows several courses (only if the person wants several). optional: savings below the price. not_needed: free without Premium."
                        },
                        "credits_remaining": {
                          "type": "integer",
                          "description": "Credit-based Premium: credits left; each coupon opened spends one."
                        },
                        "price_with_coupon": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "topic_last_30_days": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "required": [
                            "topic",
                            "courses",
                            "value",
                            "currency",
                            "window_days"
                          ],
                          "properties": {
                            "topic": {
                              "type": "string",
                              "description": "Topic slug: the one searched, otherwise the course's main topic."
                            },
                            "value": {
                              "type": "number",
                              "description": "Their total Udemy price."
                            },
                            "courses": {
                              "type": "integer",
                              "description": "Courses of this topic that became free with a coupon over the last 30 days."
                            },
                            "currency": {
                              "type": "string",
                              "const": "USD"
                            },
                            "window_days": {
                              "type": "number",
                              "const": 30
                            }
                          },
                          "description": "What one month of Premium covered on this topic, from Comidoc's history."
                        }
                      },
                      "description": "What this coupon requires and what Premium is worth here. Absent for API Pro keys."
                    },
                    "offers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Coupon offers: same fields as find_offers data[]."
                    },
                    "rating": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "topics": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "slug",
                          "title",
                          "order",
                          "confidence"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "order": {
                            "type": "integer"
                          },
                          "title": {
                            "type": "string"
                          },
                          "confidence": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "is_free": {
                      "type": "boolean",
                      "description": "Whether the course is free on Udemy without any coupon (naturally free)."
                    },
                    "reviews": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "category": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "language": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "students": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "course_url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Comidoc course page: open it in the person's browser signed in to comidoc.com (see instructions)."
                    },
                    "instructor": {
                      "type": "object",
                      "required": [
                        "name",
                        "slug",
                        "image_url",
                        "offers_in_window",
                        "window_days",
                        "is_regular_coupon_issuer"
                      ],
                      "properties": {
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "slug": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "image_url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "window_days": {
                          "type": "integer"
                        },
                        "offers_in_window": {
                          "type": "integer"
                        },
                        "is_regular_coupon_issuer": {
                          "type": "boolean"
                        }
                      }
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "offer_count": {
                      "type": "integer"
                    },
                    "subcategory": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "published_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    },
                    "thumbnail_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "coupon_history": {
                      "type": "object",
                      "required": [
                        "total_observed",
                        "is_repeat_coupon_course"
                      ],
                      "properties": {
                        "total_observed": {
                          "type": "integer"
                        },
                        "is_repeat_coupon_course": {
                          "type": "boolean"
                        }
                      }
                    },
                    "original_price": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "duration_minutes": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "is_practice_test": {
                      "type": "boolean"
                    },
                    "offers_truncated": {
                      "type": "boolean"
                    },
                    "record_updated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Comidoc record synchronization timestamp; never used by last_course_updated_after."
                    },
                    "active_offer_count": {
                      "type": "integer"
                    },
                    "returned_offer_count": {
                      "type": "integer"
                    },
                    "last_course_update_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota",
                  "requested_limit",
                  "applied_limit",
                  "max_page_size"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "limit_note": {
                    "type": "string",
                    "description": "Present only when applied_limit is lower than requested_limit: how to get the rest."
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "account_hint": {
                    "type": "string",
                    "description": "Anonymous results with coupon offers: ask about a Comidoc account. Follow it."
                  },
                  "applied_limit": {
                    "type": "integer"
                  },
                  "max_page_size": {
                    "type": "integer"
                  },
                  "requested_limit": {
                    "type": "integer"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "pagination": {
                "type": "object",
                "required": [
                  "total",
                  "limit",
                  "next_cursor"
                ],
                "properties": {
                  "limit": {
                    "type": "integer"
                  },
                  "total": {
                    "type": "integer"
                  },
                  "next_cursor": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": false
          }
        },
        {
          "name": "fetch_course",
          "title": "Fetch a course",
          "description": "Fetch one course by Udemy course ID or slug, including topics, coupon history, live redemption capacity, and the access block when it has an active coupon or is free on Udemy. Open course_url in the person's browser signed in to comidoc.com, never a coupon code (server instructions).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "course_id": {
                "type": "integer",
                "description": "Udemy's numeric course ID.",
                "exclusiveMinimum": 0
              },
              "course_slug": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "found",
              "course",
              "meta"
            ],
            "properties": {
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "account_hint": {
                    "type": "string",
                    "description": "Anonymous results with coupon offers: ask about a Comidoc account. Follow it."
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "found": {
                "type": "boolean"
              },
              "course": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "The course: same fields as search_courses data[], including offers and access."
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": false
          }
        },
        {
          "name": "find_offers",
          "title": "Find coupon offers",
          "description": "Find current or historical coupon offers. Returns total, remaining, redeemed, expiry, and observation freshness. Active offers carry an access block (Premium requirement, savings, Premium price and checkout link, recommendation). Open course_url in the person's browser signed in to comidoc.com, never a coupon code (server instructions).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "sort": {
                "enum": [
                  "latest",
                  "trend",
                  "rating",
                  "published",
                  "duration",
                  "remaining",
                  "price",
                  "expiring"
                ],
                "type": "string",
                "default": "latest"
              },
              "level": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 80,
                    "minLength": 1
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 10,
                    "minItems": 1
                  }
                ],
                "description": "One or more canonical get_filter_options values: Beginner, Intermediate, Expert, or All Levels. Matching ignores case; unknown values are rejected."
              },
              "limit": {
                "type": "integer",
                "default": 10,
                "maximum": 10,
                "minimum": 1,
                "description": "Results per page. This connection returns at most 10. Page sizes: anonymous 10, signed-in Comidoc account or free API key 25, API Pro key 100. A larger value is reduced to 10 and meta.limit_note says so; fetch the next page with pagination.next_cursor."
              },
              "query": {
                "type": "string",
                "maxLength": 120
              },
              "topic": {
                "type": "string",
                "maxLength": 120
              },
              "cursor": {
                "type": "string",
                "maxLength": 500
              },
              "rating": {
                "anyOf": [
                  {
                    "enum": [
                      "lt-4",
                      "gte-4-lt-4_5",
                      "gte-4_5"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "lt-4",
                        "gte-4-lt-4_5",
                        "gte-4_5"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "minItems": 1
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "enum": [
                      "active",
                      "expired",
                      "invalid",
                      "pending_verification",
                      "all"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "active",
                        "expired",
                        "invalid",
                        "pending_verification",
                        "all"
                      ],
                      "type": "string"
                    },
                    "maxItems": 5,
                    "minItems": 1
                  }
                ]
              },
              "category": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 120,
                    "minLength": 1
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 120,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "minItems": 1
                  }
                ],
                "description": "One or more canonical get_filter_options values. Matching ignores case; unknown values are rejected."
              },
              "duration": {
                "anyOf": [
                  {
                    "enum": [
                      "short",
                      "medium",
                      "long"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "short",
                        "medium",
                        "long"
                      ],
                      "type": "string"
                    },
                    "maxItems": 3,
                    "minItems": 1
                  }
                ]
              },
              "language": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 80,
                    "minLength": 1
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 80,
                      "minLength": 1
                    },
                    "maxItems": 50,
                    "minItems": 1
                  }
                ],
                "description": "One or more canonical get_filter_options values. Matching ignores case; unknown values are rejected."
              },
              "course_id": {
                "type": "integer",
                "description": "Udemy's numeric course ID.",
                "exclusiveMinimum": 0
              },
              "coupon_age": {
                "anyOf": [
                  {
                    "enum": [
                      "24h"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "24h"
                      ],
                      "type": "string"
                    },
                    "maxItems": 1,
                    "minItems": 1
                  }
                ]
              },
              "course_slug": {
                "type": "string",
                "maxLength": 200
              },
              "course_type": {
                "anyOf": [
                  {
                    "enum": [
                      "courses",
                      "tests"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "courses",
                        "tests"
                      ],
                      "type": "string"
                    },
                    "maxItems": 2,
                    "minItems": 1
                  }
                ]
              },
              "discount_type": {
                "anyOf": [
                  {
                    "enum": [
                      "free",
                      "percentage"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "enum": [
                        "free",
                        "percentage"
                      ],
                      "type": "string"
                    },
                    "maxItems": 2,
                    "minItems": 1
                  }
                ]
              },
              "expires_after": {
                "type": "string",
                "format": "date-time"
              },
              "unique_course": {
                "type": "boolean",
                "default": false,
                "description": "Return at most one coupon offer per Udemy course, matching the website listing."
              },
              "expires_before": {
                "type": "string",
                "format": "date-time"
              },
              "maximum_rating": {
                "type": "number",
                "maximum": 5,
                "minimum": 0
              },
              "minimum_rating": {
                "type": "number",
                "maximum": 5,
                "minimum": 0
              },
              "published_after": {
                "type": "string",
                "format": "date-time"
              },
              "coupon_created_after": {
                "type": "string",
                "format": "date-time"
              },
              "repeat_coupon_course": {
                "enum": [
                  "include",
                  "exclude",
                  "only"
                ],
                "type": "string",
                "default": "include"
              },
              "regular_coupon_issuer": {
                "enum": [
                  "include",
                  "exclude",
                  "only"
                ],
                "type": "string",
                "default": "include"
              },
              "last_course_updated_after": {
                "type": "string",
                "format": "date-time",
                "description": "Filters the last update published by Udemy."
              },
              "minimum_remaining_redemptions": {
                "type": "integer",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$defs": {
              "s1": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Only when meta.coupon_codes_included is true; otherwise null."
              }
            },
            "required": [
              "data",
              "pagination",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "coupon_code",
                    "status",
                    "status_reason",
                    "discount_type",
                    "discount_value",
                    "final_price",
                    "original_price",
                    "redemptions",
                    "expires_at",
                    "created_at",
                    "last_verified_at",
                    "last_confirmed_active_at",
                    "udemy_url",
                    "course"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "access": {
                      "type": "object",
                      "description": "Access block: same fields and rules as search_courses data[].access."
                    },
                    "course": {
                      "type": "object",
                      "required": [
                        "id",
                        "slug",
                        "title",
                        "description",
                        "thumbnail_url",
                        "instructor",
                        "category",
                        "subcategory",
                        "language",
                        "level",
                        "rating",
                        "duration_minutes",
                        "published_at",
                        "last_course_update_at",
                        "is_practice_test",
                        "is_free",
                        "original_price",
                        "topics"
                      ],
                      "properties": {
                        "id": {
                          "type": "integer",
                          "description": "Udemy's canonical numeric course ID."
                        },
                        "slug": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "level": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "title": {
                          "type": "string"
                        },
                        "rating": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "topics": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "id",
                              "slug",
                              "title"
                            ],
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "slug": {
                                "type": "string"
                              },
                              "title": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "is_free": {
                          "type": "boolean",
                          "description": "Whether the course is free on Udemy without any coupon (naturally free)."
                        },
                        "category": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "course_url": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Comidoc course page: open it in the person's browser signed in to comidoc.com (see instructions)."
                        },
                        "instructor": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "subcategory": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "published_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time"
                        },
                        "thumbnail_url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "original_price": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "duration_minutes": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "is_practice_test": {
                          "type": "boolean"
                        },
                        "last_course_update_at": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date-time"
                        }
                      }
                    },
                    "status": {
                      "enum": [
                        "active",
                        "expired",
                        "invalid",
                        "pending_verification"
                      ],
                      "type": "string"
                    },
                    "udemy_url": {
                      "$ref": "#/$defs/s1"
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "expires_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    },
                    "coupon_code": {
                      "$ref": "#/$defs/s1"
                    },
                    "final_price": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "redemptions": {
                      "type": "object",
                      "required": [
                        "total",
                        "remaining",
                        "redeemed",
                        "state",
                        "observed_at"
                      ],
                      "properties": {
                        "state": {
                          "enum": [
                            "known",
                            "unknown",
                            "stale",
                            "exhausted"
                          ],
                          "type": "string"
                        },
                        "total": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "redeemed": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "remaining": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "observed_at": {
                          "type": "string",
                          "format": "date-time"
                        }
                      }
                    },
                    "discount_type": {
                      "enum": [
                        "free",
                        "percentage"
                      ],
                      "type": "string"
                    },
                    "status_reason": {
                      "enum": [
                        "end_date_passed",
                        "redemption_limit_reached",
                        "udemy_inactive_or_expired",
                        "course_became_free",
                        "not_instructor_created",
                        "udemy_rejected_other",
                        "legacy_unclassified",
                        null
                      ],
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "discount_value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "original_price": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "last_verified_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time",
                      "description": "When Comidoc last attempted to verify this coupon, including failed attempts."
                    },
                    "last_confirmed_active_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time",
                      "description": "When Comidoc last successfully confirmed this coupon as active."
                    }
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota",
                  "requested_limit",
                  "applied_limit",
                  "max_page_size"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "limit_note": {
                    "type": "string",
                    "description": "Present only when applied_limit is lower than requested_limit: how to get the rest."
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "account_hint": {
                    "type": "string",
                    "description": "Anonymous results with coupon offers: ask about a Comidoc account. Follow it."
                  },
                  "applied_limit": {
                    "type": "integer"
                  },
                  "max_page_size": {
                    "type": "integer"
                  },
                  "requested_limit": {
                    "type": "integer"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "pagination": {
                "type": "object",
                "required": [
                  "total",
                  "limit",
                  "next_cursor"
                ],
                "properties": {
                  "limit": {
                    "type": "integer"
                  },
                  "total": {
                    "type": "integer"
                  },
                  "next_cursor": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": false
          }
        },
        {
          "name": "get_filter_options",
          "title": "Get filter options",
          "description": "Return the current categories, languages, levels, and canonical filter values accepted by search_courses and find_offers.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$defs": {
              "s1": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "label"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            "required": [
              "data",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "categories",
                  "languages",
                  "levels",
                  "course_types",
                  "durations",
                  "ratings",
                  "coupon_ages",
                  "discount_types",
                  "coupon_statuses",
                  "filter_modes",
                  "course_sorts",
                  "offer_sorts",
                  "trend_horizons"
                ],
                "properties": {
                  "levels": {
                    "$ref": "#/$defs/s1"
                  },
                  "ratings": {
                    "$ref": "#/$defs/s1"
                  },
                  "durations": {
                    "$ref": "#/$defs/s1"
                  },
                  "languages": {
                    "$ref": "#/$defs/s1"
                  },
                  "categories": {
                    "$ref": "#/$defs/s1"
                  },
                  "coupon_ages": {
                    "$ref": "#/$defs/s1"
                  },
                  "offer_sorts": {
                    "$ref": "#/$defs/s1"
                  },
                  "course_sorts": {
                    "$ref": "#/$defs/s1"
                  },
                  "course_types": {
                    "$ref": "#/$defs/s1"
                  },
                  "filter_modes": {
                    "$ref": "#/$defs/s1"
                  },
                  "discount_types": {
                    "$ref": "#/$defs/s1"
                  },
                  "trend_horizons": {
                    "$ref": "#/$defs/s1"
                  },
                  "coupon_statuses": {
                    "$ref": "#/$defs/s1"
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true
          }
        },
        {
          "name": "list_topics",
          "title": "List topics",
          "description": "Discover Comidoc topic slugs by catalog size, name, or temporal trend.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "sort": {
                "enum": [
                  "catalog",
                  "trending",
                  "name"
                ],
                "type": "string",
                "default": "catalog"
              },
              "limit": {
                "type": "integer",
                "default": 10,
                "maximum": 10,
                "minimum": 1,
                "description": "Results per page. This connection returns at most 10. Page sizes: anonymous 10, signed-in Comidoc account or free API key 25, API Pro key 100. A larger value is reduced to 10 and meta.limit_note says so; fetch the next page with pagination.next_cursor."
              },
              "query": {
                "type": "string",
                "maxLength": 120
              },
              "cursor": {
                "type": "string",
                "maxLength": 500
              },
              "horizon": {
                "enum": [
                  "24h",
                  "7d",
                  "30d"
                ],
                "type": "string",
                "default": "7d"
              },
              "minimum_courses": {
                "type": "integer",
                "default": 1,
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "data",
              "pagination",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "slug",
                    "title",
                    "description",
                    "keywords",
                    "aliases",
                    "courses_count",
                    "updated_at"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "aliases": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "keywords": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "courses_count": {
                      "type": "integer"
                    },
                    "active_offer_courses_count": {
                      "type": "integer"
                    }
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota",
                  "requested_limit",
                  "applied_limit",
                  "max_page_size"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "limit_note": {
                    "type": "string",
                    "description": "Present only when applied_limit is lower than requested_limit: how to get the rest."
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "account_hint": {
                    "type": "string",
                    "description": "Anonymous results with coupon offers: ask about a Comidoc account. Follow it."
                  },
                  "applied_limit": {
                    "type": "integer"
                  },
                  "max_page_size": {
                    "type": "integer"
                  },
                  "requested_limit": {
                    "type": "integer"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "pagination": {
                "type": "object",
                "required": [
                  "total",
                  "limit",
                  "next_cursor"
                ],
                "properties": {
                  "limit": {
                    "type": "integer"
                  },
                  "total": {
                    "type": "integer"
                  },
                  "next_cursor": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true
          }
        },
        {
          "name": "fetch_topic",
          "title": "Fetch a topic",
          "description": "Fetch one topic and its active-offer course count by Comidoc slug.",
          "inputSchema": {
            "type": "object",
            "required": [
              "slug"
            ],
            "properties": {
              "slug": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "found",
              "topic",
              "meta"
            ],
            "properties": {
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "found": {
                "type": "boolean"
              },
              "topic": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "id",
                  "slug",
                  "title",
                  "description",
                  "keywords",
                  "aliases",
                  "courses_count",
                  "updated_at"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "aliases": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "updated_at": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "courses_count": {
                    "type": "integer"
                  },
                  "active_offer_courses_count": {
                    "type": "integer"
                  }
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true
          }
        },
        {
          "name": "get_trending_courses",
          "title": "Get trending courses",
          "description": "Return temporal course trends for 24 hours, 7 days, or 30 days with score version, rank movement, signals, and coupon availability.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 10,
                "maximum": 10,
                "minimum": 1,
                "description": "Results per page. This connection returns at most 10. Page sizes: anonymous 10, signed-in Comidoc account or free API key 25, API Pro key 100. A larger value is reduced to 10 and meta.limit_note says so; trend lists have no next page."
              },
              "horizon": {
                "enum": [
                  "24h",
                  "7d",
                  "30d"
                ],
                "type": "string",
                "default": "7d"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "data",
              "calculated_at",
              "score_version",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "rank",
                    "rank_change",
                    "trend_score",
                    "score_version",
                    "signals",
                    "course"
                  ],
                  "properties": {
                    "rank": {
                      "type": "integer"
                    },
                    "course": {
                      "type": "object",
                      "description": "The course: same fields as search_courses data[], including offers and access."
                    },
                    "signals": {},
                    "rank_change": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "trend_score": {
                      "type": "number"
                    },
                    "score_version": {
                      "type": "string"
                    }
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota",
                  "requested_limit",
                  "applied_limit",
                  "max_page_size"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "limit_note": {
                    "type": "string",
                    "description": "Present only when applied_limit is lower than requested_limit: how to get the rest."
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "account_hint": {
                    "type": "string",
                    "description": "Anonymous results with coupon offers: ask about a Comidoc account. Follow it."
                  },
                  "applied_limit": {
                    "type": "integer"
                  },
                  "max_page_size": {
                    "type": "integer"
                  },
                  "requested_limit": {
                    "type": "integer"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "calculated_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "score_version": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": false
          }
        },
        {
          "name": "get_trending_topics",
          "title": "Get trending topics",
          "description": "Return temporal topic trends for 24 hours, 7 days, or 30 days with rank movement and transparent score signals.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 10,
                "maximum": 10,
                "minimum": 1,
                "description": "Results per page. This connection returns at most 10. Page sizes: anonymous 10, signed-in Comidoc account or free API key 25, API Pro key 100. A larger value is reduced to 10 and meta.limit_note says so; trend lists have no next page."
              },
              "horizon": {
                "enum": [
                  "24h",
                  "7d",
                  "30d"
                ],
                "type": "string",
                "default": "7d"
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "data",
              "calculated_at",
              "score_version",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "rank",
                    "rank_change",
                    "trend_score",
                    "score_version",
                    "signals",
                    "topic"
                  ],
                  "properties": {
                    "rank": {
                      "type": "integer"
                    },
                    "topic": {
                      "type": "object",
                      "required": [
                        "id",
                        "slug",
                        "title",
                        "description",
                        "courses_count"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "slug": {
                          "type": "string"
                        },
                        "title": {
                          "type": "string"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "courses_count": {
                          "type": "integer"
                        }
                      }
                    },
                    "signals": {},
                    "rank_change": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "trend_score": {
                      "type": "number"
                    },
                    "score_version": {
                      "type": "string"
                    }
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota",
                  "requested_limit",
                  "applied_limit",
                  "max_page_size"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "limit_note": {
                    "type": "string",
                    "description": "Present only when applied_limit is lower than requested_limit: how to get the rest."
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "account_hint": {
                    "type": "string",
                    "description": "Anonymous results with coupon offers: ask about a Comidoc account. Follow it."
                  },
                  "applied_limit": {
                    "type": "integer"
                  },
                  "max_page_size": {
                    "type": "integer"
                  },
                  "requested_limit": {
                    "type": "integer"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "calculated_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              },
              "score_version": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true
          }
        },
        {
          "name": "show_course_cards",
          "title": "Show course cards",
          "description": "Show the courses you chose as visual cards in clients that display MCP Apps: image, title, instructor, rating, duration, Udemy price and price with the coupon, coupons left, coupon end date, and language. By default, when you present several courses, call it once after your searches with the final unique Udemy course IDs or slugs from Comidoc results, in display order; never pass a course you did not get from Comidoc. Answer in text instead (or in addition) when the person asks for a list, a comparison, or a short answer, or when your client does not display apps; your text answer stays complete without the cards (title, key facts, course_url). Each card opens course_url, the Comidoc course page; it never shows a coupon code.",
          "inputSchema": {
            "type": "object",
            "required": [
              "courses"
            ],
            "properties": {
              "courses": {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    }
                  ]
                },
                "maxItems": 10,
                "minItems": 1,
                "description": "The final courses to show, in display order: Udemy course IDs (numbers) or Comidoc slugs taken from previous Comidoc results. At most 10 for this connection."
              },
              "heading": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1,
                "description": "A short heading matching the person's request."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "heading",
              "data",
              "shown",
              "not_found",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "course_id",
                    "slug",
                    "title",
                    "description",
                    "thumbnail_url",
                    "instructor",
                    "language",
                    "level",
                    "rating",
                    "duration_minutes",
                    "original_price",
                    "final_price",
                    "price_currency",
                    "is_free_on_udemy",
                    "has_active_coupon",
                    "expires_at",
                    "remaining_redemptions",
                    "availability_checked_at",
                    "course_url"
                  ],
                  "properties": {
                    "slug": {
                      "type": "string"
                    },
                    "level": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "title": {
                      "type": "string"
                    },
                    "rating": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "language": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "course_id": {
                      "type": "integer"
                    },
                    "course_url": {
                      "type": "string",
                      "format": "uri",
                      "description": "The Comidoc course page the card opens, with the agent UTM (agent_card)."
                    },
                    "expires_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    },
                    "instructor": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "final_price": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Price on Udemy with the active coupon (0 for a free coupon); null without an active coupon."
                    },
                    "thumbnail_url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "uri"
                    },
                    "original_price": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "price_currency": {
                      "type": "string",
                      "const": "USD"
                    },
                    "duration_minutes": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "is_free_on_udemy": {
                      "type": "boolean"
                    },
                    "has_active_coupon": {
                      "type": "boolean"
                    },
                    "remaining_redemptions": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "availability_checked_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  }
                }
              },
              "kind": {
                "type": "string",
                "const": "comidoc_course_cards"
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "shown": {
                "type": "integer"
              },
              "heading": {
                "type": "string"
              },
              "not_found": {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "string",
                      "maxLength": 200,
                      "minLength": 1
                    }
                  ]
                },
                "description": "Requested identifiers that match no active Comidoc course."
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_my_access",
          "title": "Get my Premium access",
          "description": "The connected person's Comidoc Premium status: whether it is active, the plan, its renewal date, credits left, and the page where they manage it. Requires an OAuth connection with account:read; nothing sensitive is returned. Without a connection, the server answers 401 with an OAuth challenge.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "premium",
              "manage_url",
              "premium_offer",
              "meta"
            ],
            "properties": {
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              },
              "premium": {
                "type": "object",
                "required": [
                  "active",
                  "access",
                  "plan",
                  "renews",
                  "renews_at",
                  "access_ends_at",
                  "credits_remaining"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "premium_monthly",
                      "premium_seven_days",
                      "premium_lifetime",
                      "premium_wallet",
                      "premium_gift",
                      null
                    ],
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "access": {
                    "enum": [
                      "unlimited",
                      "credits",
                      "none"
                    ],
                    "type": "string",
                    "description": "unlimited: every course_url goes straight to Udemy with the coupon applied in the person's browser signed in to comidoc.com. credits: one credit per coupon opened. none: no Premium, course_url shows the Premium offer. Coupon codes are never returned."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Whether the person has Comidoc Premium right now."
                  },
                  "renews": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "renews_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time"
                  },
                  "access_ends_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "When Premium ends if it does not renew; null for lifetime or renewing plans."
                  },
                  "credits_remaining": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  }
                }
              },
              "manage_url": {
                "type": "string",
                "format": "uri",
                "description": "Page where the person manages or cancels Premium, signed in on comidoc.com."
              },
              "premium_offer": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "price",
                  "currency",
                  "period",
                  "checkout_url"
                ],
                "properties": {
                  "price": {
                    "type": "number"
                  },
                  "period": {
                    "type": "string",
                    "const": "month"
                  },
                  "currency": {
                    "type": "string",
                    "const": "USD"
                  },
                  "checkout_url": {
                    "type": "string",
                    "format": "uri"
                  }
                },
                "description": "The plan currently sold, only when the person has no Premium."
              }
            }
          },
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true
          }
        },
        {
          "name": "submit_coupons",
          "title": "Submit Udemy coupons",
          "description": "Queue up to 500 Udemy coupon links for verification, in the name of the connected person. Free. Requires an OAuth connection with coupons:submit (without one, the server answers 401 with an OAuth challenge) or a Comidoc developer key with that scope. Only call when the user asks to submit the links. Returns a result for each link in input order.",
          "inputSchema": {
            "type": "object",
            "required": [
              "submissions"
            ],
            "properties": {
              "submissions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "Udemy course URL, optionally including ?couponCode=…"
                    },
                    "coupon_code": {
                      "type": "string",
                      "description": "Code for a URL without an embedded coupon code."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 500,
                "minItems": 1
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "data",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "index",
                    "status",
                    "message"
                  ],
                  "properties": {
                    "index": {
                      "type": "integer"
                    },
                    "status": {
                      "enum": [
                        "queued_course",
                        "queued_coupon",
                        "already_queued",
                        "already_exists_coupon",
                        "skipped_coupon",
                        "invalid",
                        "retry"
                      ],
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "submission_id": {
                      "type": "string"
                    }
                  }
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "request_id",
                  "source",
                  "plan",
                  "coupon_codes_included",
                  "quota"
                ],
                "properties": {
                  "plan": {
                    "enum": [
                      "free",
                      "pro"
                    ],
                    "type": "string"
                  },
                  "quota": {
                    "type": "object",
                    "required": [
                      "limit",
                      "used",
                      "remaining",
                      "resets_at"
                    ],
                    "properties": {
                      "used": {
                        "type": "integer"
                      },
                      "limit": {
                        "type": "integer"
                      },
                      "remaining": {
                        "type": "integer"
                      },
                      "resets_at": {
                        "type": "string",
                        "format": "date-time"
                      }
                    }
                  },
                  "source": {
                    "enum": [
                      "direct",
                      "rapidapi",
                      "mcp"
                    ],
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "coupon_codes_included": {
                    "type": "boolean"
                  }
                }
              }
            }
          },
          "annotations": {
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "comidoc-course-cards",
          "uri": "ui://comidoc/course-cards-efaab9051fa6.html",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Cards for the courses an agent selected: image, title, instructor, rating, duration, prices, coupon state, and a link to the Comidoc course page."
        }
      ],
      "prompts": [
        {
          "name": "find_free_courses",
          "description": "Search verified Udemy coupons on a topic, read each access block, and advise honestly on whether Comidoc Premium is worth it, with the checkout link for the person to open.",
          "arguments": [
            {
              "name": "topic",
              "required": true,
              "description": "What the person wants to learn, for example python or excel."
            }
          ]
        }
      ]
    },
    "instructions": "Use Comidoc to discover verified Udemy courses, coupon offers, topics, and trends.\nCall get_filter_options before using a category, language, or level value that you are unsure about.\nReads need no account. Active coupons are a Comidoc Premium benefit. Results show which courses have an active coupon, never the code. To open a coupon, open course_url in the person's browser where they are signed in to comidoc.com: with Premium it goes straight to Udemy with the coupon applied; without Premium it shows the course and the Premium offer. If a Cloudflare check asks for an interaction, hand over to the person.\nWhen the person has Premium, or wants it, connect this client to Comidoc with OAuth: the client opens the Comidoc sign-in, which creates the account if needed. Once the person has Premium, access.granted is true and there is nothing to buy: open each course_url in their browser signed in to comidoc.com, as access.how_to_open says. Coupon codes are never returned to a Premium connection.\nget_my_access (OAuth, account:read) says whether the connected person has Premium, the plan, its renewal date and where to manage it.\nOn an anonymous connection: Coupons open with Comidoc Premium. Unless the person already told you, ask once in the conversation whether they have a Comidoc account. If they do, call get_my_access: it asks them to sign in, then results use their account. If they don't, explain once what Premium would bring them, from the access block (savings on these courses, free courses on this topic in the last 30 days, the price and checkout_url), and suggest it only when recommendation is worth_it; never insist.\ncoupon_code and udemy_url are present only when meta.coupon_codes_included is true, which only developer API Pro keys get. Those callers receive no access block.\nEvery course or offer with an active coupon, and every course that is free on Udemy, carries an access block: requires, price, price_with_coupon, savings, currency, premium (plan sold, price, period, checkout_url), topic_last_30_days, recommendation, reason.\nAdvise honestly. Recommend Premium when recommendation is worth_it with reason savings_cover_premium, or when the person wants several courses in a topic and topic_last_30_days shows several courses became free there over the last 30 days. Say Premium is not needed when requires is none. Otherwise mention it as optional, once, and never push it.\nQuote prices only from access.price, access.price_with_coupon, access.savings, and access.premium. Never invent, round up, or remember a price, and never promise future coupons: topic_last_30_days is history, not a guarantee.\nPayment is always done by the person: hand over access.premium.checkout_url and let them open it. Never pay, subscribe, or create an account on their behalf.\nNever recommend the developer API plans to someone who wants to learn: they are for people building an application or a coupon platform.\nPage sizes: anonymous calls return up to 10 results per page; a Comidoc account connected with OAuth (free, Premium or not) or a free API key, up to 25; an API Pro key, up to 100. The limit field of each list tool shows this connection's cap. List results report meta.requested_limit, meta.applied_limit and meta.max_page_size, and meta.limit_note when a page was capped.\nA person who wants more results gets them page by page with pagination.next_cursor. Signing in with a free Comidoc account raises the page size to 25.\nAPI Pro ($49/month) is for developers building an app, bot or site: up to 100 results per page and coupon codes. Never suggest it to someone who wants to learn.\nBy default, when you present several courses, call show_course_cards once with the final course ids or slugs from Comidoc results: clients that display MCP Apps show them as cards. Answer in text instead (or in addition) when the person asks for a list, a comparison, or a short answer, or when your client does not display apps. Your text answer stays complete without the cards: ti"
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}