[
  {
    "name": "euipo_search_trademarks",
    "description": "Search EU trademarks (EUTM) at the EUIPO — \"find EU trademarks containing NIKE in Nice classes 9 and 25\". Use for EU brand clearance and competitor trademark portfolios. Returns matching marks (application number, mark text, status, owner, Nice classes, filing date) plus raw. Example: euipo_search_trademarks({ verbal_element: \"nike\", nice_classes: [9, 25], status: \"REGISTERED\", _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "verbal_element": {
          "type": "string",
          "description": "Text/word element of the mark to match (wildcards added automatically), e.g. \"nike\". Multi-word values are quoted safely."
        },
        "applicant": {
          "type": "string",
          "description": "Applicant / owner name to match, e.g. \"Nike Innovate\"."
        },
        "nice_classes": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "Nice classification classes to filter by, e.g. [9, 25]."
        },
        "status": {
          "type": "string",
          "description": "Trademark status filter, e.g. \"REGISTERED\", \"APPLICATION_FILED\", \"EXPIRED\". Comma-separate for multiple."
        },
        "query": {
          "type": "string",
          "description": "Advanced: raw RSQL filter passed through verbatim (e.g. verbalElement==\"*nike*\";niceClasses=in=(9,25)). Overrides the friendly params above."
        },
        "size": {
          "type": "integer",
          "description": "Max results per page (default 20, max 100)."
        },
        "page": {
          "type": "integer",
          "description": "Zero-based page index for pagination (default 0)."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "_apiKey"
      ]
    }
  },
  {
    "name": "euipo_trademark",
    "description": "Retrieve a single EU trademark by its application or registration number from the EUIPO — \"look up EUTM 018123456\". Returns the full record (mark text, status, owner/representative, Nice classes, goods & services, filing/registration/expiry dates) plus raw. Example: euipo_trademark({ number: \"018123456\", _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "number": {
          "type": "string",
          "description": "EUTM application or registration number, e.g. \"018123456\"."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "number",
        "_apiKey"
      ]
    }
  },
  {
    "name": "euipo_search_designs",
    "description": "Search registered Community designs (RCD) at the EUIPO — \"find registered EU designs owned by Adidas in Locarno class 02\". Use for design-filing landscape and competitor design portfolios. Returns matching designs (design number, indication of product, status, owner, Locarno classes, filing date) plus raw. Example: euipo_search_designs({ owner: \"adidas\", locarno_classes: [\"02\"], _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "indication": {
          "type": "string",
          "description": "Indication of product / design keyword to match (wildcards added automatically), e.g. \"footwear\"."
        },
        "owner": {
          "type": "string",
          "description": "Design owner / applicant name to match, e.g. \"adidas\"."
        },
        "locarno_classes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Locarno classification classes to filter by, e.g. [\"02\", \"09\"]."
        },
        "status": {
          "type": "string",
          "description": "Design status filter, e.g. \"REGISTERED\", \"EXPIRED\". Comma-separate for multiple."
        },
        "query": {
          "type": "string",
          "description": "Advanced: raw RSQL filter passed through verbatim (e.g. indicationOfProduct==\"*footwear*\";locarnoClasses=in=(02)). Overrides the friendly params above."
        },
        "size": {
          "type": "integer",
          "description": "Max results per page (default 20, max 100)."
        },
        "page": {
          "type": "integer",
          "description": "Zero-based page index for pagination (default 0)."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "_apiKey"
      ]
    }
  },
  {
    "name": "euipo_search_goods_services",
    "description": "Explore the EUIPO's harmonised Nice goods-and-services classification (TMClass) — \"find accepted goods-and-services terms for 'software' in Nice class 9\". Use when preparing a trademark filing or checking whether a term is already a recognised, pre-classified term. Returns matching terms with their Nice class and concept id, plus raw. Example: euipo_search_goods_services({ term: \"software\", nice_class: 9, language: \"en\", _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "term": {
          "type": "string",
          "description": "Text to search for within goods-and-services terms, e.g. \"software\"."
        },
        "nice_class": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "Nice classification class number(s) to restrict the search to, e.g. [9] or [9, 42]. Also accepts a single integer."
        },
        "language": {
          "type": "string",
          "description": "EU official language code for the search and results, e.g. \"en\", \"es\", \"de\", \"fr\". Required by the upstream API; defaults to \"en\"."
        },
        "parent_concept_id": {
          "type": "string",
          "description": "Restrict to children of this taxonomy concept id (for browsing the classification tree)."
        },
        "include_term_variants": {
          "type": "boolean",
          "description": "Include term variants in the results (default false)."
        },
        "size": {
          "type": "integer",
          "description": "Max results per page (default 20)."
        },
        "page": {
          "type": "integer",
          "description": "Zero-based page index for pagination (default 0)."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "_apiKey"
      ]
    }
  },
  {
    "name": "euipo_validate_goods_services",
    "description": "Validate a list of goods-and-services terms against the EUIPO's harmonised database (TMClass) — checks whether each term is a recognised (\"harmonized\") term, and flags invalid characters, duplicates, forbidden terms, and length problems. Use before filing to catch terms an examiner would object to. Returns per-term accepted/not-accepted status plus raw. Example: euipo_validate_goods_services({ terms: [\"computer software\", \"C@ts and dog$\"], nice_class: 9, language: \"en\", _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "terms": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Goods-and-services terms to validate, e.g. [\"computer software\", \"downloadable mobile applications\"]."
        },
        "nice_class": {
          "type": "integer",
          "description": "Nice classification class the terms belong to, e.g. 9. The upstream validates terms per class."
        },
        "language": {
          "type": "string",
          "description": "Language the terms are written in, e.g. \"en\". Required by the upstream API; defaults to \"en\"."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "terms",
        "_apiKey"
      ]
    }
  },
  {
    "name": "euipo_search_product_indications",
    "description": "Search the EUIPO's harmonised Locarno product-indications classification (DSClass) used for registered Community design filings — \"find accepted design indications for 'chair'\". Returns matching indications with their Locarno class/subclass and concept id, plus raw. Example: euipo_search_product_indications({ term: \"chair\", locarno_class: 6, language: \"en\", _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "term": {
          "type": "string",
          "description": "Text to search for within product-indication terms, e.g. \"chair\"."
        },
        "locarno_class": {
          "type": "integer",
          "description": "Locarno classification class number to restrict the search to, e.g. 6."
        },
        "locarno_subclass": {
          "type": "integer",
          "description": "Locarno classification subclass number (requires locarno_class)."
        },
        "language": {
          "type": "string",
          "description": "EU official language code for the search and results, e.g. \"en\". Required by the upstream API; defaults to \"en\"."
        },
        "parent_concept_id": {
          "type": "string",
          "description": "Restrict to children of this taxonomy concept id (for browsing the classification tree)."
        },
        "size": {
          "type": "integer",
          "description": "Max results per page (default 20)."
        },
        "page": {
          "type": "integer",
          "description": "Zero-based page index for pagination (default 0)."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "_apiKey"
      ]
    }
  },
  {
    "name": "euipo_search_persons",
    "description": "Search applicants or representatives on record with the EUIPO for trademark/design procedures — \"find the EUIPO representative record for a named law firm\". Each row carries its role (e.g. APPLICANT_BUSINESS, APPLICANT_INDIVIDUAL, REPRESENTATIVE_EUIPO_PROFESSIONAL) and its source. Privacy: street/city/postal-code address details are withheld for individual persons — only country-level location is kept; business/association entities keep their registered address. Example: euipo_search_persons({ name: \"adidas\", role: \"applicant\", country: \"DE\", _apiKey: \"client_id:client_secret\" })",
    "inputSchema": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name to search for, e.g. \"adidas\" or a representative's firm/individual name."
        },
        "role": {
          "type": "string",
          "enum": [
            "applicant",
            "representative"
          ],
          "description": "Which EUIPO person register to search: \"applicant\" (default) or \"representative\"."
        },
        "country": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2 country code to filter by, e.g. \"DE\", \"US\"."
        },
        "city": {
          "type": "string",
          "description": "City to filter by, e.g. \"Alicante\". Only meaningful for business/association entities (withheld for individuals in the response)."
        },
        "size": {
          "type": "integer",
          "description": "Max results per page (default 20)."
        },
        "page": {
          "type": "integer",
          "description": "Zero-based page index for pagination (default 0)."
        },
        "_apiKey": {
          "type": "string",
          "description": "EUIPO OAuth credentials as \"client_id:client_secret\" from dev.euipo.europa.eu."
        }
      },
      "required": [
        "_apiKey"
      ]
    }
  }
]
