com.gleanmark/trademark-search

Est-ce que com.gleanmark/trademark-search est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.gleanmark/trademark-search » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 64 outils

• analyze_prosecution_history≈ 186 tokens

  Analyze the full prosecution history of a trademark — narrative timeline of office actions, responses, examiner decisions, and current status, with examiner-behavior patterns. For authenticated users this launches asynchronously (usually done in under a minute; longer for large file histories) and returns a processing handle used to retrieve the completed result once ready.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "analyze_prosecution_history", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• analyze_ttab_proceeding≈ 232 tokens

  Analyze a TTAB (Trademark Trial and Appeal Board) proceeding in depth — fetches and analyzes proceeding documents, identifies key arguments, and returns a structured summary with timeline, party positions, and strategic assessment. For authenticated full-mode runs this launches asynchronously (typically 1-2 minutes) and returns a processing handle used to retrieve the completed result once ready.

  Paramètres, retour & exemple (2)

  Paramètres

  • quick_mode · boolean · optionnel
    Quick mode skips lower-priority documents for faster results
  • proceeding_number · string · requis
    TTAB proceeding number (e.g., "91284756")

  Exemple d'appel

  {"name": "analyze_ttab_proceeding", "arguments": {"proceeding_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_brand_availability≈ 322 tokens

  Quick brand-name screen: checks whether the name's domains are registered and whether the .com site is in use, looks for similar registered trademarks in the given industries or classes, and returns a screening tier (avoid, probably avoid, promising, or no close conflicts surfaced) with the top conflicts and a domain snapshot. It is a first look, not a clearance search: it does not cover common-law use, state registrations or a full goods-relatedness analysis, so a result with no conflicts means none surfaced in this screen, not that the name is available. run_knockout_search is the fuller trademark conflict search.

  Paramètres, retour & exemple (4)

  Paramètres

  • brand_name · string · requis
    Brand name to check
  • industries · array · optionnel
    Industry categories
  • nice_classes · array · optionnel
    Nice classes to check against
  • business_description · string · optionnel
    Brief description of the business

  Exemple d'appel

  {"name": "check_brand_availability", "arguments": {"brand_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_domain_availability≈ 196 tokens

  Check domain availability for a brand name. Returns status (available, parked, commercially used, or taken) for each TLD, plus .com variations (e.g., getbrand.com, brandhq.com).

  Paramètres, retour & exemple (2)

  Paramètres

  • tlds · array · optionnel
    TLDs to check. Defaults to com/ai/app/io/co when omitted.
  • brand_name · string · requis
    Brand name to check (e.g., "Moonlight Coffee")

  Exemple d'appel

  {"name": "check_domain_availability", "arguments": {"brand_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• compare_marks≈ 377 tokens

  Compare two trademarks for likelihood of confusion using DuPont-style analysis. Returns similarity scores and risk assessment.

  Paramètres, retour & exemple (3)

  Paramètres

  • mark_a · string · requis
    First trademark to compare
  • mark_b · string · requis
    Second trademark to compare
  • nice_classes · array · optionnel
    Nice classes for overlap analysis

  Exemple d'appel

  {"name": "compare_marks", "arguments": {"mark_a": "texte", "mark_b": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"mark_a": "texte", "mark_b": "texte", "risk_level": "High", "similarity": {}, "risk_explanation": "texte", "open_in_gleanmark": "texte", "nice_class_overlap": true, "dupont_factors_summary": []}}

• count_filings_by_period≈ 339 tokens

  Counts U.S. trademark applications filed across the whole register in a date range, grouped by calendar year, month or day, with each period split into U.S.-filed and Madrid Protocol (79-series) applications and the change from the previous period. Answers questions such as how many trademark applications were filed in 2025 and how that compares with 2024, or which month of a year had the most filings. Counts are one per serial number by the filing date on the USPTO record; they are calendar periods, not USPTO fiscal-year statistics, and not class counts. Returns data_through, the latest filing date on the register; recent periods grow as late records arrive.

  Paramètres, retour & exemple (3)

  Paramètres

  • end_date · string · requis
    Last filing date to count, YYYY-MM-DD, inclusive (e.g. 2025-12-31).
  • group_by · string · optionnel · year | month | day
    Period size. Daily counts cover at most about a year.
  • start_date · string · requis
    First filing date to count, YYYY-MM-DD (e.g. 2024-01-01).

  Exemple d'appel

  {"name": "count_filings_by_period", "arguments": {"end_date": "texte", "start_date": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• count_trademarks_by_attributes≈ 506 tokens

  Counts and previews USPTO marks by record attributes (drawing type, standard-character claim, Nice class, status, and combinations of these), with breakdowns by mark type, standard character and class, plus how complete the underlying data is. Claimed-color criteria can be combined with these attributes; counts by color alone, rankings, lists and color vocabulary are outside its scope.

  Paramètres, retour & exemple (9)

  Paramètres

  • limit · integer · optionnel
  • mark_types · array · optionnel
  • nice_classes · array · optionnel
  • status_filter · string · optionnel · all | live | dead | registered | pending | cancelled | abandoned
    Use registered for currently live registrations; live also includes pending applications.
  • class_match_mode · string · optionnel · any | all
  • color_match_mode · string · optionnel · all | only | only_bw
    all permits additional claimed colors; only requires exactly the selected colors; only_bw also permits black/white.
  • standard_characters · boolean · optionnel
  • claimed_color_shades · array · optionnel
    Exact canonical shades from the USPTO color claim.
  • claimed_color_families · array · optionnel
    Normalized color families. Burgundy and maroon, for example, count as red.

  Exemple d'appel

  {"name": "count_trademarks_by_attributes", "arguments": {"limit": 1, "mark_types": [], "nice_classes": [], "status_filter": "all", "class_match_mode": "any", "color_match_mode": "all"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• fetch≈ 160 tokens

  Retrieve the full USPTO record for one trademark, using an id returned by the search tool. Returns mark, owner, status, filing and registration dates, Nice classes, the goods and services text, and counsel of record, with a public gleanmark.com URL for citation.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Document id from a search result, e.g. "uspto-72303482". A bare serial number is also accepted.

  Exemple d'appel

  {"name": "fetch", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_chain_of_title≈ 261 tokens

  Traces who has owned a trademark over time: the ownership stages the USPTO recorded, from the original applicant or registrant through each later owner, plus any recorded assignment documents GleanMark holds. Answers questions such as who owns a mark now versus who filed it, whether it was sold, transferred or assigned, and how it reached its current owner, including chain-of-title and due-diligence questions. lookup_trademark shows only the current owner. Owners listed within one stage are joint owners, not successive ones. Not a title opinion.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number of the mark, e.g. "98725143". Registration numbers are not accepted — resolve to a serial first with lookup_trademark or search_trademarks.

  Exemple d'appel

  {"name": "get_chain_of_title", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_class_relationships≈ 228 tokens

  Look up coordinated Nice classes or related Nice classes for a given class number.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Maximum rows to return.
  • class_number · integer · requis
    Nice class number to inspect.
  • include_legacy · boolean · optionnel
    Include legacy US classes A, B, and 200 when returning coordinated classes.
  • relationship_type · string · optionnel · coordinated | related
    Whether to return USPTO coordinated classes or curated related classes.

  Exemple d'appel

  {"name": "get_class_relationships", "arguments": {"class_number": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_cohort_event_intervals≈ 683 tokens

  Measures the time between two prosecution events across a group of marks, e.g. the average days from Office Action to publication for marks published in Q2 2026. The group is chosen by an anchor event (preset: publication, notice_of_publication, registration, notice_of_allowance, abandonment or first_office_action, or raw event codes, where a trailing * matches a prefix) within a date window of up to 366 days; the interval runs from a start event to an end event. Returns the average, median and percentiles in days, how many marks in the group had no start event, and example marks. Samples up to max_sample marks from the start of the window and says when the sample is truncated. Event codes beyond the presets are listed by get_event_code_reference.

  Paramètres, retour & exemple (9)

  Paramètres

  • end_event · string · optionnel · first_office_action | publication | notice_of_publication | registration | notice_of_allowance | abandonment
    Interval end event (first occurrence on/after the start event). Defaults to the cohort event itself.
  • max_sample · integer · optionnel
    Max cohort marks to measure (default 1000, max 2000).
  • start_event · string · optionnel · first_office_action | publication | notice_of_publication | registration | notice_of_allowance | abandonment
    Interval start event (first occurrence on/before the cohort event). Defaults to first_office_action.
  • cohort_event · string · optionnel · first_office_action | publication | notice_of_publication | registration | notice_of_allowance | abandonment
    Preset anchor event defining cohort membership (e.g. publication = PUBO).
  • cohort_date_to · string · requis
    Cohort window end (YYYY-MM-DD). Required. Window max 366 days.
  • end_event_codes · array · optionnel
    Alternative to end_event: raw event codes (trailing * = prefix).
  • cohort_date_from · string · requis
    Cohort window start (YYYY-MM-DD). Required.
  • start_event_codes · array · optionnel
    Alternative to start_event: raw event codes (trailing * = prefix).
  • cohort_event_codes · array · optionnel
    Alternative to cohort_event: raw USPTO event codes; trailing * matches a prefix (e.g. "NPUB*").

  Exemple d'appel

  {"name": "get_cohort_event_intervals", "arguments": {"cohort_date_to": "texte", "cohort_date_from": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_correspondent_marks≈ 370 tokens

  Get all trademarks handled by a specific attorney/correspondent, with prosecution event counts and office action flags. Returns marks sorted by prosecution history length. Use this for attorney-specific mark queries.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Maximum marks to return.
  • search_term · string · optionnel
    Attorney name to search for (e.g., "Todd Schneider"). Will find the best match.
  • status_filter · string · optionnel · all | pending | registered | live | dead
    Filter marks by status.
  • correspondent_id · string · optionnel
    Alias for canonical_correspondent_id.
  • correspondent_name · string · optionnel
    Alias for search_term. Preferred when the caller already knows this is a correspondent name.
  • recent_window_days · integer · optionnel
    How many days back to count recent office actions. Use 90 for "last 3 months".
  • canonical_correspondent_id · string · optionnel
    UUID of the correspondent (from search_attorneys result). Use this if you already have the ID.

  Exemple d'appel

  {"name": "get_correspondent_marks", "arguments": {"limit": 1, "search_term": "texte", "status_filter": "all", "correspondent_id": "texte", "correspondent_name": "texte", "recent_window_days": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_correspondent_specialization≈ 648 tokens

  Summarize what a named correspondent specializes in, including top clients, top Nice classes, and prosecution-versus-TTAB profile. Use this when the user asks what a specific correspondent or attorney specializes in.

  Paramètres, retour & exemple (5)

  Paramètres

  • url_key · string · optionnel
    Known correspondent url_key, if already resolved.
  • search_term · string · optionnel
    Correspondent or attorney name to resolve.
  • top_class_limit · integer · optionnel
    Maximum top Nice classes to return.
  • top_client_limit · integer · optionnel
    Maximum top clients to return.
  • correspondent_name · string · optionnel
    Alias for search_term.

  Exemple d'appel

  {"name": "get_correspondent_specialization", "arguments": {"url_key": "texte", "search_term": "texte", "top_class_limit": 1, "top_client_limit": 1, "correspondent_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"found": true, "summary": "texte", "url_key": "texte", "headline": "texte", "firm_name": "texte", "ttab_profile": {}, "primary_email": "texte", "firm_detail_url": "texte", "practice_profile": {}, "correspondent_name": "texte", "prosecution_profile": {}, "correspondent_detail_url": "texte"}}

• get_deadline_satisfaction_mapping≈ 254 tokens

  Check what role a USPTO event code plays for a deadline type (satisfies it, triggers it, abandons it, suspends it) per the deadline vocabulary table deadline_event_roles — office action response, opposition period, Statement of Use, Section 8/9/15, post-registration office action, ITU notice.

  Paramètres, retour & exemple (2)

  Paramètres

  • event_code · string · requis
    USPTO event code to inspect.
  • deadline_type · string · requis · office_action_response | opposition_period | section_15_initial | section_8_and_9_renewal | section_8_and_9_subsequent | section_8_initial | statement_of_use | post_registration_office_action
    Deadline family to test against.

  Exemple d'appel

  {"name": "get_deadline_satisfaction_mapping", "arguments": {"event_code": "texte", "deadline_type": "office_action_response"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_event_code_reference≈ 213 tokens

  Look up USPTO event codes used in trademark prosecution. Search by exact code, code prefix, or keyword in the event description. Returns the code, human-readable description, and category.

  Paramètres, retour & exemple (3)

  Paramètres

  • code · string · optionnel
    Exact USPTO event code or prefix (e.g., "OAIN" for exact, "OA" for prefix match).
  • limit · integer · optionnel
    Maximum number of results to return (default 20).
  • search · string · optionnel
    Keyword to search in event descriptions (e.g., "office action", "abandoned").

  Exemple d'appel

  {"name": "get_event_code_reference", "arguments": {"code": "texte", "limit": 1, "search": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_event_status_mapping≈ 149 tokens

  Look up which USPTO status code and status definition most commonly follow a specific prosecution event code.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum mappings to return.
  • event_code · string · requis
    USPTO event code to inspect.

  Exemple d'appel

  {"name": "get_event_status_mapping", "arguments": {"event_code": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_fame_profile≈ 237 tokens

  Get the full fame profile for a brand (by mark wording or brand stem): fame tier (broad/dilution-tier vs market-specific), the fame "path" it cleared (concentrated dominant family vs large multi-class portfolio), its famous class footprint, corporate-family portfolio size and class breadth, brand-stem crowding, and TTAB enforcement history. Use to explain WHY a mark is (or is not) famous, or to profile a senior mark before a §2(d) / opposition / dilution strategy. Circumstantial signal, not statutory fame proof.

  Paramètres, retour & exemple (1)

  Paramètres

  • mark_or_stem · string · requis
    A mark ("THE DISNEY STORE") or a bare brand stem ("disney"). Both resolve to the same family.

  Exemple d'appel

  {"name": "get_fame_profile", "arguments": {"mark_or_stem": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_firm_correspondent_tasks≈ 327 tokens

  Resolves a trademark law firm and returns its action-required work: overdue deadlines and those in the next window, plus recent Office Actions from case-file events and prosecution documents, with flags for a filed response and for Section 2(d) refusals. Answers questions such as which correspondent tasks a firm has in the next 30 days or which recent Office Actions a firm has received.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Maximum deadlines/recent OAs/task previews to return.
  • firm_name · string · requis
    Law firm name or normalized key, e.g. "Imani Law" or "imanilawllp".
  • deadline_days · integer · optionnel
    How many days ahead to include action-required deadlines. Overdue items still in grace are also included.
  • recent_oa_days · integer · optionnel
    How many days back to include recent Office Actions.

  Exemple d'appel

  {"name": "get_firm_correspondent_tasks", "arguments": {"firm_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_firm_deadlines≈ 948 tokens

  Get public, system-generated trademark deadlines across marks handled by a specific law firm. Uses public firm resolution and prosecution mappings only. Does not expose any workspace, client, reminder, or user-created deadline data.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Maximum number of deadline rows to return. Defaults to 50.
  • days_back · integer · optionnel
    How far back to include overdue or recently resolved deadlines. Defaults to 60 days.
  • firm_name · string · requis
    Law firm name to resolve and analyze.
  • days_ahead · integer · optionnel
    How far forward to look. Defaults to 365 days.
  • status_filter · string · optionnel · active | pending | overdue | satisfied | cancelled | all
    Deadline status filter. Defaults to active.
  • include_opposition_period · boolean · optionnel
    Deprecated alias for include_informational_windows. Defaults to false.
  • include_informational_windows · boolean · optionnel
    Include informational review windows such as publication opposition windows. Defaults to false.

  Exemple d'appel

  {"name": "get_firm_deadlines", "arguments": {"firm_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"title": "texte", "total": 1, "message": "texte", "returned": 1, "days_back": 1, "deadlines": [], "firm_name": "texte", "days_ahead": 1, "is_partial": true, "status_filter": "texte", "counts_by_type": {}, "firm_detail_url": "texte"}}

• get_firm_oa_outcomes≈ 209 tokens

  Resolve a trademark law firm and compute mark-level Office Action outcome rates: how many firm-handled marks registered after receiving an OA, raw and excluding pending matters. Use this for questions like "what percentage registered after an OA?" or "OA success rate for this firm".

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum examples to return in each outcome bucket.
  • firm_name · string · requis
    Law firm name or normalized key, e.g. "Imani Law" or "imanilawllp".

  Exemple d'appel

  {"name": "get_firm_oa_outcomes", "arguments": {"firm_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_firm_top_correspondents≈ 634 tokens

  Ranks the correspondents or attorneys within one named law firm by filing volume, with prosecution and TTAB activity counts. Answers questions such as who the top correspondents at Fross Zelnick Lehrman & Zissu are.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum correspondents to return.
  • firm_name · string · requis
    Law firm name or normalized firm key.

  Exemple d'appel

  {"name": "get_firm_top_correspondents", "arguments": {"firm_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"summary": "texte", "headline": "texte", "returned": 1, "firm_name": "texte", "leader_name": "texte", "presentation": {}, "firm_detail_url": "texte", "leader_detail_url": "texte", "leader_total_filings": 1, "total_correspondents": 1}}

• get_latest_office_action≈ 166 tokens

  Returns the most recent Office Action for a trademark serial number, the latest recorded response if there is one, and the refusal grounds parsed from the Office Action text, with the cited registration numbers. refusal_grounds is taken from the text of the action, not from the document title.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "get_latest_office_action", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mark_ai_summary≈ 130 tokens

  Get an AI-generated deep-dive summary of a specific trademark. Covers mark details, goods/services, status, owner, prosecution context, and any active legal proceedings.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "get_mark_ai_summary", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mark_deadlines≈ 994 tokens

  Get public, system-generated trademark deadlines for a specific mark. Accepts a serial number directly or resolves a mark name to a specific serial first. Does not expose any workspace, client, reminder, or user-created deadline data.

  Paramètres, retour & exemple (8)

  Paramètres

  • limit · integer · optionnel
    Maximum number of deadline rows to return. Defaults to 50.
  • days_back · integer · optionnel
    How far back to include overdue or recently resolved deadlines. Defaults to 60 days.
  • days_ahead · integer · optionnel
    How far forward to look. Defaults to 365 days.
  • subject_name · string · optionnel
    Specific mark text or serial-number-like query. Use when the user names the mark instead of giving a serial.
  • serial_number · string · optionnel
    USPTO serial number for the specific mark.
  • status_filter · string · optionnel · active | pending | overdue | satisfied | cancelled | all
    Deadline status filter. Defaults to active.
  • include_opposition_period · boolean · optionnel
    Deprecated alias for include_informational_windows. Defaults to false.
  • include_informational_windows · boolean · optionnel
    Include informational review windows such as publication opposition windows. Defaults to false.

  Exemple d'appel

  {"name": "get_mark_deadlines", "arguments": {"limit": 1, "days_back": 1, "days_ahead": 1, "subject_name": "texte", "serial_number": "texte", "status_filter": "active"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"title": "texte", "total": 1, "message": "texte", "returned": 1, "days_back": 1, "deadlines": [], "mark_name": "texte", "days_ahead": 1, "is_partial": true, "owner_name": "texte", "serial_number": "texte", "status_filter": "texte"}}

• get_mark_international_profile≈ 243 tokens

  Get the international / foreign footprint of a U.S. trademark by serial number: its Madrid Protocol international registration (IR number, date, status, renewal), whether it was filed as a 66(a) Madrid extension, Madrid maintenance (§8/§15, renewal), and the foreign applications/registrations it claims as priority or basis (country, registration number, dates). Use this for ANY question about a mark's foreign, international, Madrid Protocol, WIPO, or EUIPO registrations. Data comes from USPTO records, so it is only available for marks with a USPTO record — it does not query WIPO/EUIPO live.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "get_mark_international_profile", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_mark_owner_landscape≈ 745 tokens

  Show which owners hold marks matching a shared trademark term and summarize what else those owners have in their broader portfolios. Use this for crowded owner-landscape questions like "Which companies own a trademark for COMET?" or "Who owns trademarks for GLEAN?" Returns the matching owners ranked by footprint, with each owner's wider portfolio context.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    Maximum number of owners to return.
  • mark_text · string · requis
    Trademark term to analyze across owners, such as COMET or GLOW.
  • match_mode · string · optionnel · contains | exact | starts_with
    How to match the mark text: contains, exact, or starts_with.
  • nice_classes · array · optionnel
    Optional Nice classes to narrow the landscape.
  • status_filter · string · optionnel · all | live | dead | registered | pending
    Optional status filter. Default is live.

  Exemple d'appel

  {"name": "get_mark_owner_landscape", "arguments": {"mark_text": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"title": "texte", "owners": [], "summary": "texte", "headline": "texte", "returned": 1, "mark_text": "texte", "match_mode": "contains", "leader_name": "texte", "nice_classes": [], "status_filter": "all", "leader_detail_url": "texte", "total_matching_marks": 1}}

• get_mark_prosecution_summary≈ 138 tokens

  Get a compact prosecution summary for a trademark serial number. Returns current status, document counts, latest office action/response dates, milestones, and the latest key event.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "get_mark_prosecution_summary", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_nice_classes≈ 288 tokens

  Get information about Nice Classification classes used for trademark registration. Lookup specific class numbers or search for classes by keyword.

  Paramètres, retour & exemple (2)

  Paramètres

  • search_term · string · optionnel
    Search term to find relevant classes (e.g., "software", "clothing", "restaurant")
  • class_numbers · array · optionnel
    Specific class numbers to look up (1-45)

  Exemple d'appel

  {"name": "get_nice_classes", "arguments": {"search_term": "texte", "class_numbers": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"classes": [], "open_in_gleanmark": "texte"}}

• get_owner_ai_summary≈ 179 tokens

  Get an AI-generated strategic analysis of a trademark owner. Covers brand protection philosophy, litigation posture, portfolio evolution, class distribution, and likely future behavior. Results are cached for 30 days.

  Paramètres, retour & exemple (1)

  Paramètres

  • normalized_owner · string · requis
    Normalized owner name (lowercase, no punctuation, e.g., "appleinc", "homeboxofficeinc"). Use search_by_owner first to find the correct normalized name.

  Exemple d'appel

  {"name": "get_owner_ai_summary", "arguments": {"normalized_owner": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_owner_deadlines≈ 943 tokens

  Get public, system-generated trademark deadlines across a specific owner’s marks. Uses public USPTO owner resolution only. Does not expose any workspace, client, reminder, or user-created deadline data.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Maximum number of deadline rows to return. Defaults to 50.
  • days_back · integer · optionnel
    How far back to include overdue or recently resolved deadlines. Defaults to 60 days.
  • days_ahead · integer · optionnel
    How far forward to look. Defaults to 365 days.
  • owner_name · string · requis
    Owner name to resolve and analyze.
  • status_filter · string · optionnel · active | pending | overdue | satisfied | cancelled | all
    Deadline status filter. Defaults to active.
  • include_opposition_period · boolean · optionnel
    Deprecated alias for include_informational_windows. Defaults to false.
  • include_informational_windows · boolean · optionnel
    Include informational review windows such as publication opposition windows. Defaults to false.

  Exemple d'appel

  {"name": "get_owner_deadlines", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"title": "texte", "total": 1, "message": "texte", "returned": 1, "days_back": 1, "deadlines": [], "days_ahead": 1, "is_partial": true, "owner_name": "texte", "status_filter": "texte", "counts_by_type": {}, "counts_by_status": {}}}

• get_owner_filing_trends≈ 198 tokens

  Get a trademark owner's filing trends over time — yearly filing counts broken down by Nice class. Shows how the owner's trademark portfolio has evolved.

  Paramètres, retour & exemple (3)

  Paramètres

  • end_year · integer · optionnel
    End year (default: current year)
  • owner_name · string · requis
    Owner name as shown in USPTO records (e.g., "NIKE, INC."). Use search_by_owner first to find the exact name.
  • start_year · integer · optionnel
    Start year (default: 2000)

  Exemple d'appel

  {"name": "get_owner_filing_trends", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_owner_goods_keywords≈ 193 tokens

  Get the most frequent goods/services keywords for a trademark owner. Shows what products and services the owner focuses on, useful for understanding their brand strategy and identifying class patterns.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Max keywords to return
  • owner_name · string · requis
    Owner name as shown in USPTO records (e.g., "NIKE, INC."). Use search_by_owner first to find the exact name.

  Exemple d'appel

  {"name": "get_owner_goods_keywords", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_owner_related_parties≈ 298 tokens

  Find entities likely related to a trademark owner (predecessors, subsidiaries, sister companies) from USPTO evidence: shared ownership history on the same marks, shared filing addresses (agent addresses excluded), and shared distinctive name tokens. Returns evidence and a high/possible confidence tier per hit — treat 'possible' as tentative. Use when analyzing an owner's full corporate family, portfolio scope, or whether two owners of similar marks are actually affiliated. Pass the owner name exactly as recorded (resolve with resolve_trademark_subject first if ambiguous).

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum related parties to return
  • owner_name · string · requis
    Owner name as recorded at the USPTO (e.g., "Netflix, Inc."). Normalized internally to the owner key.

  Exemple d'appel

  {"name": "get_owner_related_parties", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_owner_ttab_enforcement≈ 707 tokens

  Analyze one trademark owner's TTAB enforcement in a single call. Filters and counts only target marks that actually satisfy the requested class, mark-type, and claimed-color criteria; separately reports all targets attached to qualifying proceedings. Supports exact class-only questions with target_class_match=only. Claimed-color metadata identifies candidate marks but does not prove color was alleged in the pleading; use analyze_ttab_proceeding for that evidence.

  Paramètres, retour & exemple (13)

  Paramètres

  • role · string · optionnel · plaintiff | defendant | any
    Use plaintiff for proceedings the owner initiated.
  • limit · integer · optionnel
  • date_to · string · optionnel
    Inclusive filing-date end in YYYY-MM-DD format.
  • date_from · string · optionnel
    Inclusive filing-date start in YYYY-MM-DD format.
  • owner_name · string · requis
    Owner name, including a likely typo such as "Niked" for NIKE, Inc.
  • target_classes · array · optionnel
    Nice classes required on the qualifying challenged/target marks.
  • proceeding_types · array · optionnel
  • target_mark_types · array · optionnel
  • include_extensions · boolean · optionnel
    Include Extensions of Time to Oppose, reported separately from substantive cases.
  • target_class_match · string · optionnel · any | all | only
    any = at least one selected class; all = every selected class; only = exactly the selected class set and no others.
  • include_owner_marks · boolean · optionnel
    Include the enforcing owner's asserted marks. Leave false for class/type/color target lists to keep the result compact.
  • target_claims_color · boolean · optionnel
    When true, require a USPTO color claim on each qualifying target mark.
  • target_color_families · array · optionnel
    Optional normalized color families that qualifying target marks must claim.

  Exemple d'appel

  {"name": "get_owner_ttab_enforcement", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_owner_ttab_stats≈ 238 tokens

  Returns a compact TTAB history for one owner: counts of inter partes proceedings, oppositions, cancellations, extensions of time to oppose and appeals, broken down by the owner's role. The total counts every record, including extensions and cases the owner defended, so it is not the number of oppositions the owner started. get_owner_ttab_enforcement covers date ranges and the marks and classes challenged.

  Paramètres, retour & exemple (3)

  Paramètres

  • year · integer · optionnel
    Filter to a specific year
  • limit · integer · optionnel
  • owner_name · string · requis
    Owner name to search for

  Exemple d'appel

  {"name": "get_owner_ttab_stats", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_prosecution_document≈ 405 tokens

  Retrieve one specific USPTO prosecution document by the stable document_id returned from list_prosecution_documents, USPTO document id, code, or date. Returns the working USPTO document link, extraction/readability status, cached document text, and optional query-centered excerpts. Use text_query when the user asks what the document says about a particular issue. Call with serial_number alone and it returns the list of documents on file (newest first) so you can pick one — no separate list_prosecution_documents call needed.

  Paramètres, retour & exemple (7)

  Paramètres

  • max_chars · integer · optionnel
  • text_query · string · optionnel
    Optional word or phrase; returns up to five excerpts centered on matches.
  • document_id · string · optionnel
    Stable GleanMark document UUID; the exact selector. Omit every selector to get the list of documents for this serial and pick one from it.
  • document_code · string · optionnel
    Document code such as NFIN, FREF, ROA, or RFR.
  • document_date · string · optionnel
    Exact document date in YYYY-MM-DD.
  • serial_number · string · requis
    Eight-digit USPTO serial number.
  • uspto_document_id · string · optionnel
    USPTO document identifier from list_prosecution_documents.

  Exemple d'appel

  {"name": "get_prosecution_document", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_prosecution_timeline≈ 136 tokens

  Get the prosecution timeline for a trademark — chronological list of office actions, responses, and key events (publication, registration, suspension, etc.). Raw data without AI analysis.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "get_prosecution_timeline", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_reference_lookup≈ 337 tokens

  Look up USPTO or TTAB reference codes and small lookup tables such as status codes, statement types, legal entity types, Nice classes, design codes, and TTAB proceeding/status/role codes.

  Paramètres, retour & exemple (5)

  Paramètres

  • code · string · optionnel
    Exact code to look up when known.
  • limit · integer · optionnel
    Maximum entries to return.
  • query · string · optionnel
    Free-text search across code descriptions and labels.
  • after_code · string · optionnel
    Cursor from next_after_code for the next page when browsing a reference table without code/query filters.
  • reference_type · string · requis · nice_class | uspto_event | uspto_status | uspto_statement_type | uspto_legal_entity_type | uspto_party_type | uspto_mark_drawing_code | uspto_mark_type
    Which small lookup/reference table to search.

  Exemple d'appel

  {"name": "get_reference_lookup", "arguments": {"reference_type": "nice_class"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_similar_marks≈ 480 tokens

  Find USPTO trademarks similar to a given mark name. Uses examiner-style knockout search with phonetic, trigram, and component matching to identify potential conflicts. Returns similarity_score (mark-only similarity) and confusion_score (blended mark + commercial overlap). Useful for trademark clearance searches.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Maximum number of similar marks to return
  • mark_text · string · requis
    Trademark name to find similar marks for
  • include_dead · boolean · optionnel
    Include dead/abandoned trademarks in results
  • nice_classes · array · optionnel
    Filter by Nice Classification classes (similar marks in same classes are higher risk)

  Exemple d'appel

  {"name": "get_similar_marks", "arguments": {"mark_text": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"query_mark": "texte", "risk_summary": "texte", "similar_marks": [], "open_in_gleanmark": "texte"}}

• get_top_filers≈ 1342 tokens

  Get a ranked filer table for a date range, filer type, and optional Nice classes. Handles questions like "Who are the top 10 filers in Class 9 in 2025?" Returns ranked rows with per-filer live, registered, and pending counts plus corpus totals. A single call covers the full ranked list: `limit` (up to 100) sets the number of rows and the date range may span multiple years. `offset` reaches ranks beyond 100 or a specific band (ranks 40-45 = `limit: 6, offset: 39`).

  Paramètres, retour & exemple (9)

  Paramètres

  • limit · integer · optionnel
    Maximum number of ranked filers to return. Up to 100 in a single call.
  • offset · integer · optionnel
    Rank to start from, 0-based. Use with limit to reach deeper bands: ranks 40-45 are limit 6, offset 39. Ranks in the response already account for this.
  • rank_by · string · optionnel · filings | registrations | success_rate
    What to order by. 'filings' is raw volume and is dominated by high-volume online filing services. 'success_rate' ranks by registrations as a share of DECIDED outcomes (registered vs abandoned), which surfaces quality rather than throughput. Every response carries success_rate_percent and supplemental_percent regardless of ordering.
  • end_date · string · requis
    Inclusive end date in YYYY-MM-DD format.
  • filer_type · string · optionnel · owner | firm | correspondent
    Whether to rank owners, law firms, or individual correspondents.
  • start_date · string · requis
    Inclusive start date in YYYY-MM-DD format.
  • min_filings · integer · optionnel
    Minimum filings a filer needs to appear. Defaults to 25 when rank_by is success_rate, 0 otherwise. Required for rate rankings: without a floor a filer with 2 marks and 2 registrations scores 100% and outranks a firm that won 900 of 1,000.
  • nice_classes · array · optionnel
    Optional Nice classes to filter by. Use integers like 42 or 9.
  • filer_profile · string · optionnel · all | law_firm | full_service | prosecution_only | filing_service | in_house
    Restrict to a kind of filer. Firm rankings only. 'filing_service' is a curated, human-verified list of productized high-volume filing operations (LegalZoom, Rocket Lawyer, Swyft and similar) — use 'law_firm' to EXCLUDE them, which is what a user means by "exclude the agencies/factories". 'full_service' is a law firm that litigates (files TTAB oppositions/cancellations); 'prosecution_only' is a law firm that mostly does not — that is practice scope, NOT a judgment about quality, and prosecution-only firms are entirely legitimate. 'in_house' is a company's own trademark department (Mattel, Disney), not a firm serving clients.

  Exemple d'appel

  {"name": "get_top_filers", "arguments": {"end_date": "texte", "start_date": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"title": "texte", "summary": "texte", "end_date": "texte", "headline": "texte", "returned": 1, "filer_type": "owner", "start_date": "texte", "leader_name": "texte", "nice_classes": [], "presentation": {}, "leader_detail_url": "texte", "leader_filing_count": 1}}

• get_ttab_document≈ 269 tokens

  Retrieve and read one specific TTABVUE filing by proceeding number and entry number. Returns filing metadata, a working USPTO TTABVUE viewer link, direct PDF link when available, extraction/readability status, document text, and optional query-centered excerpts. Use get_ttab_proceeding_details first when the entry number is unknown.

  Paramètres, retour & exemple (4)

  Paramètres

  • max_chars · integer · optionnel
  • text_query · string · optionnel
    Optional word or phrase; returns up to five excerpts centered on matches.
  • entry_number · integer · requis
    TTABVUE entry number returned by get_ttab_proceeding_details.
  • proceeding_number · string · requis
    Seven- or eight-digit TTAB proceeding number.

  Exemple d'appel

  {"name": "get_ttab_document", "arguments": {"entry_number": 1, "proceeding_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_ttab_proceeding_details≈ 178 tokens

  Get raw details for a TTAB proceeding — parties, involved marks, counsel, and recent filings with entry numbers and working TTABVUE document links. Use get_ttab_document to read one selected filing. Use get_owner_ttab_enforcement for owner-wide distributions and analyze_ttab_proceeding for AI-powered merits analysis.

  Paramètres, retour & exemple (1)

  Paramètres

  • proceeding_number · string · requis
    TTAB proceeding number (e.g., "91284756")

  Exemple d'appel

  {"name": "get_ttab_proceeding_details", "arguments": {"proceeding_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_ttab_top_opposition_filers≈ 386 tokens

  Ranks the parties that filed the most TTAB oppositions (or cancellations) across the whole Board in a date range. Answers market-wide questions such as which party filed the most oppositions in April 2026. Takes a calendar date range. One owner's record is covered by get_owner_ttab_stats, and one proceeding by get_ttab_proceeding_details.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    How many ranked parties to return.
  • end_date · string · requis
    End of the filing-date window, YYYY-MM-DD. Inclusive. For "April 2026" use 2026-04-30.
  • party_role · string · optionnel · plaintiff | defendant
    Rank the party that FILED (plaintiff/opposer) or the party that was targeted (defendant). "Filed the most oppositions" means plaintiff.
  • start_date · string · requis
    Start of the filing-date window, YYYY-MM-DD. Inclusive. For "April 2026" use 2026-04-01.
  • proceeding_type · string · optionnel · opposition | cancellation
    Which proceeding type to rank. Oppositions challenge a pending application; cancellations attack a registration.

  Exemple d'appel

  {"name": "get_ttab_top_opposition_filers", "arguments": {"end_date": "texte", "start_date": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• is_mark_famous≈ 319 tokens

  Checks whether a trademark is famous, and whether it is famous for a specific market, using the applicant's Nice class as a stand-in for that market (fame is market-specific under Joseph Phelps Vineyards v. Fairmont: a mark famous for electronics is not automatically famous for fresh fruit). Returns is_famous, famous_in_class, the fame tier (broad household-name fame or market-specific fame), the classes where the mark is famous, portfolio size, and the corporate family's record as a TTAB plaintiff. Relevant to whether a mark is famous, the strength of a senior mark under Section 2(d), and dilution eligibility under Section 43(c). A circumstantial signal, not proof of statutory fame.

  Paramètres, retour & exemple (2)

  Paramètres

  • mark · string · requis
    The mark wording to check (e.g. "MONSTER", "DELTA", "APPLE").
  • class · string · optionnel
    Optional Nice class number 1-45 (e.g. "25"), used as a proxy for the relevant market to test market-specific fame. Omit for a class-agnostic read.

  Exemple d'appel

  {"name": "is_mark_famous", "arguments": {"mark": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_prosecution_documents≈ 192 tokens

  List prosecution documents for a trademark serial number, including stable document identifiers, working USPTO links when available, extraction/readability status, office actions, responses, notices, and other dated filings. Use get_prosecution_document to read one selected document.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum documents to return (default 50).
  • serial_number · string · requis
    USPTO serial number

  Exemple d'appel

  {"name": "list_prosecution_documents", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• lookup_trademark≈ 417 tokens

  Get detailed information about a specific USPTO trademark by its serial number. Returns owner, status, filing dates, goods/services, correspondent (attorney/law firm of record — use this for "which firm represents/is correspondent for" questions), and more.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number (exactly 8 digits)

  Exemple d'appel

  {"name": "lookup_trademark", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"found": true, "trademark": "texte", "serial_number": "texte", "open_in_gleanmark": "texte"}}

• phonetic_search≈ 500 tokens

  Finds trademarks whose whole mark sounds like the given mark, using Metaphone codes and trigram similarity with a whole-mark threshold. Because it compares entire marks, a multi-word mark that only contains a sound-alike word is not returned: for QUICK, KWIK REWARDS does not appear even though KWIK sounds like QUICK. An empty or short result does not show that no sound-alike marks exist and is not a clearance result; run_knockout_search is the conflict search.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
  • mark_text · string · requis
    Trademark name to find sound-alike matches for
  • include_dead · boolean · optionnel
  • nice_classes · array · optionnel
    Filter by Nice classes
  • similarity_threshold · number · optionnel

  Exemple d'appel

  {"name": "phonetic_search", "arguments": {"mark_text": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"results": [], "query_mark": "texte", "total_found": 1, "search_method": "texte", "open_in_gleanmark": "texte"}}

• recommend_nice_classes≈ 183 tokens

  Recommend Nice trademark classes based on a business description. Returns the most relevant classes with confidence scores and explanations.

  Paramètres, retour & exemple (2)

  Paramètres

  • industry · string · optionnel
    Optional industry category for context
  • business_description · string · requis
    Detailed description of the business, products, or services (minimum 50 characters). Pass the full user description, do not summarize.

  Exemple d'appel

  {"name": "recommend_nice_classes", "arguments": {"business_description": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• research_office_action≈ 188 tokens

  Research the Office Action for a trademark — returns structured refusal categories, latest OA/response context, cited marks, and third-party registrations that support coexistence arguments. For authenticated users this launches asynchronously (typically 1-2 minutes) and returns a processing handle used to retrieve the completed result once ready.

  Paramètres, retour & exemple (1)

  Paramètres

  • serial_number · string · requis
    USPTO serial number of the trademark with the Office Action

  Exemple d'appel

  {"name": "research_office_action", "arguments": {"serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resolve_trademark_subject≈ 276 tokens

  Matches a name to one trademark entity (an owner, law firm, correspondent, mark, TTAB proceeding, client or portfolio) and returns the match with its identifiers, or the top candidates when the name is ambiguous. Resolving clients and portfolios requires a signed-in account.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum number of candidate matches to return.
  • entity · string · requis · owner | firm | correspondent | mark | proceeding | client | portfolio
    What kind of trademark subject to resolve.
  • subject_name · string · requis
    Raw owner, firm, correspondent, mark text/serial number, TTAB proceeding query, client name, or portfolio name to resolve.

  Exemple d'appel

  {"name": "resolve_trademark_subject", "arguments": {"entity": "owner", "subject_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• run_knockout_search≈ 822 tokens

  Runs a scored trademark conflict (knockout) search over 14M USPTO records with the same engine as the GleanMark app: exact, phonetic, trigram and component-word matching, coordinated class expansion, foreign-equivalent translation and design codes, scored for mark similarity and commercial overlap. Returns results grouped into four risk tiers (very high, high, medium, low) with confusion scores, a four-level headline verdict (critical conflicts, elevated risk, moderate risk, low risk) with a one-line reason, and a sample of dead marks in the same naming territory. goods_description, when supplied, is scored for goods and services relatedness; without it, scoring uses classes only, which understates conflicts between related goods in different classes. owner_name adds the applicant's existing marks in the searched classes. It searches trademarks only, not domains or web use; check_brand_availability covers domains. Most searches finish in under a minute. Requires a signed-in GleanMark account.

  Paramètres, retour & exemple (7)

  Paramètres

  • mark_name · string · requis
    The proposed mark name to search for (e.g., "BARLYTICS", "WAR MUSCLE")
  • owner_name · string · optionnel
    Optional: the applicant/owner company name (e.g., "APPLE INC."). Adds portfolio context showing their existing marks in the searched classes and flags same-owner conflicts.
  • max_results · integer · optionnel
    Maximum scored results to return (default 100). The verdict and risk bands are computed over the full candidate set regardless; 100 rows is plenty for a knockout answer, and larger payloads only slow the response.
  • design_codes · array · optionnel
    USPTO design codes to include in the search (optional)
  • include_dead · boolean · optionnel
    Default false — LEAVE IT FALSE for availability / "what would block me" questions: dead and abandoned marks cannot block a filing, and the live-only search already returns a dead-mark sample for naming context. Setting true scans the abandoned register too and takes 2-3 minutes, which exceeds most client timeouts (measured 2026-09-09: live-only 23s; include_dead 150s then failed). Only set true when the user explicitly asks about dead or abandoned marks.
  • nice_classes · array · optionnel
    Nice classes to search (e.g., ["042", "035"]). The search automatically expands to coordinated classes. Optional — omit to search all classes.
  • goods_description · string · optionnel
    The goods/services the applicant plans to sell (e.g., "hair extensions; synthetic hair pieces and wigs"). STRONGLY RECOMMENDED whenever known: it drives goods-relatedness scoring, so conflicts on related goods surface at their true risk band instead of being understated by class-only overlap.

  Exemple d'appel

  {"name": "run_knockout_search", "arguments": {"mark_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• run_safe_analytics≈ 2729 tokens

  Runs a constrained analytics query over owners, law firms and correspondents (rankings, counts, snapshots and timelines) and returns the results without exposing database details. Suited to custom aggregate business questions that a single search or summary tool does not answer.

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Maximum number of ranked rows, preview marks, or timeline events to return.
  • entity · string · requis · owner | firm | correspondent
    What to analyze. Ranking currently supports owners. Count, snapshot, and timeline also support firms and correspondents.
  • metric · string · optionnel · filings | pending_marks | live_marks | registered_marks | recent_office_actions
    Required for count. Ranking currently supports filings only.
  • filters · object · optionnel
  • subject_name · string · optionnel
    Required for count, snapshot, and timeline. Examples: "Ideaya Biosciences", "Goodwin Procter", or "Todd Schneider".
  • analysis_type · string · requis · ranking | count | snapshot | timeline
    Business analytics mode: ranking, count, snapshot, or timeline.

  Exemple d'appel

  {"name": "run_safe_analytics", "arguments": {"entity": "owner", "analysis_type": "ranking"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"title": "texte", "entity": "owner", "metric": "texte", "summary": "texte", "rankings": [], "returned": 1, "resolution": "texte", "count_result": "texte", "subject_name": "texte", "analysis_type": "ranking", "filters_applied": {}, "snapshot_result": "texte"}}

• search≈ 180 tokens

  Search GleanMark's USPTO trademark database and return citable results. Each result is a US trademark record with a stable id, a human-readable title (mark, owner and status) and a public gleanmark.com URL. Use the fetch tool with a returned id to read the full record. Covers 14M+ USPTO applications and registrations, live and dead.

  Paramètres, retour & exemple (1)

  Paramètres

  • query · string · requis
    Search terms — a mark name, a brand, or an owner name. Example: "spicy coke" or "Apple Inc".

  Exemple d'appel

  {"name": "search", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_attorneys≈ 571 tokens

  Search for trademark attorneys or law firms. Returns prosecution statistics, TTAB proceeding counts (as plaintiff/defendant), and contact information.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum number of results to return
  • search_term · string · requis
    Attorney name or law firm name to search for
  • search_type · string · optionnel · attorneys | firms
    Search for individual attorneys or law firms

  Exemple d'appel

  {"name": "search_attorneys", "arguments": {"search_term": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"query": "texte", "results": [], "search_type": "attorneys", "open_in_gleanmark": "texte"}}

• search_by_owner≈ 349 tokens

  Search for trademark owners by name. Use this to resolve or list candidate owners, not for owner counts, rankings, prosecution snapshots, or recent activity checks. Returns matching companies/individuals with their trademark portfolio statistics (total marks, live/dead counts, registered/pending).

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Maximum number of owners to return
  • owner_name · string · requis
    Owner name to search for (company or individual)

  Exemple d'appel

  {"name": "search_by_owner", "arguments": {"owner_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"query": "texte", "owners": [], "open_in_gleanmark": "texte"}}

• search_claimed_colors≈ 745 tokens

  Searches or counts U.S. trademarks by the colors they claim, parsed from USPTO color-claim statements. Two levels: level="family" (16 color families; red also finds dark red, maroon and burgundy) and level="shade" (the exact term claimed, e.g. dark red). match="all" finds marks claiming at least the given colors, match="only" marks claiming exactly those colors, and match="only_bw" the same while also allowing black and white. claimed=false counts marks whose statement says color is not claimed. Modes: count, top_owners, list_marks, vocabulary (the valid families or shades with counts), explain_term (the family a shade belongs to) and by_serial (what one mark claims).

  Paramètres, retour & exemple (11)

  Paramètres

  • mode · string · optionnel · count | top_owners | list_marks | vocabulary | explain_term | by_serial
    count = how many marks match. top_owners = who owns the most. list_marks = sample the matches. vocabulary = valid colour terms + corpus counts. explain_term = a shade's family. by_serial = what one mark claims.
  • term · string · optionnel
    Required for mode="explain_term", e.g. "maroon".
  • level · string · optionnel · family | shade
    family = 16 broad families (red covers maroon). shade = the exact claimed term.
  • limit · integer · optionnel
    Rows for top_owners, list_marks, vocabulary.
  • match · string · optionnel · all | only | only_bw
    all = claims at least these. only = claims exactly these, nothing else. only_bw = exactly these, allowing black/white (usually background).
  • colors · array · optionnel
    Colour terms, e.g. ["orange","green","red"]. Must be real families or shades — call mode="vocabulary" if unsure. Omit to match every colour-claiming mark.
  • status · string · optionnel · any | live | dead | registered | pending
    registered/pending are narrower than live. "How many live REGISTRATIONS" means status="registered".
  • claimed · boolean · optionnel
    false = count marks whose statement disclaims colour ("Color is not claimed as a feature of the mark").
  • nice_class · string · optionnel
    Restrict to one Nice class, e.g. "25" or "025".
  • serial_number · string · optionnel
    Eight-digit serial number for mode="by_serial".
  • registration_number · string · optionnel
    Registration number for mode="by_serial"; resolved to its serial number automatically.

  Exemple d'appel

  {"name": "search_claimed_colors", "arguments": {"mode": "count", "term": "texte", "level": "family", "limit": 1, "match": "all", "colors": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_design_codes≈ 567 tokens

  Find US trademarks by USPTO design code — the codes examiners assign to the visual elements of a logo (26.17.01 = straight bands, 24.11 = crowns). Accepts dotted (26.17.01) or packed (261701) form. USPTO design vocabulary is literal and narrow: it records "Bands, straight" where a person says "stripe", and has no entry for words like "swoosh", so a plain shape word resolves to a code through mode="search_codes" before marks can be counted or listed. Modes: count, top_owners, list_marks, by_serial (what codes one mark carries), describe_code, search_codes. Omitting mode infers it from the arguments supplied.

  Paramètres, retour & exemple (9)

  Paramètres

  • mode · string · optionnel · count | top_owners | list_marks | by_serial | describe_code | search_codes
    search_codes = find a code from a word. describe_code = what a code means. count/top_owners/list_marks = marks carrying the codes. Omit it and the mode is inferred: query -> search_codes, serial_number/registration_number -> by_serial, codes -> count.
  • codes · array · optionnel
    Design codes, dotted or packed, e.g. ["26.17.01"].
  • limit · integer · optionnel
  • match · string · optionnel · all | any
    all = mark carries every code. any = at least one.
  • query · string · optionnel
    Required for mode="search_codes". A shape word: band, bar, circle, star, triangle, chevron, crown, leaf, arrow, shield.
  • status · string · optionnel · any | live | dead | registered | pending
  • nice_class · string · optionnel
    Restrict to one Nice class, e.g. "25".
  • serial_number · string · optionnel
    Eight-digit serial number for mode="by_serial".
  • registration_number · string · optionnel
    Registration number for mode="by_serial"; resolved to its serial number automatically.

  Exemple d'appel

  {"name": "search_design_codes", "arguments": {"mode": "count", "codes": [], "limit": 1, "match": "all", "query": "texte", "status": "any"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_goods_services≈ 629 tokens

  Full-text search over the goods and services identifications of 14M USPTO marks, for questions such as which other owners claim a product in their goods (competitive landscape, descriptiveness or crowded-field evidence, identification drafting precedent). Keyword-based: the query is tokenized and matched against each mark's indexed goods keywords (match_mode all requires every keyword, any requires at least one). Rows include a short excerpt around the matched clause, not the full identification. mode=count returns how many marks claim the goods, with class and status breakdowns; mode=top_owners ranks the owners claiming them; neither returns rows. Searches goods and services text, not mark names; run_knockout_search and search_trademarks search mark names.

  Paramètres, retour & exemple (8)

  Paramètres

  • mode · string · optionnel · list_marks | count | top_owners
    list_marks returns rows; count returns totals + class/status breakdowns only; top_owners ranks owners by matching-mark count.
  • sort · string · optionnel · relevance | filing_date_desc | filing_date_asc | registration_date_desc | registration_date_asc | owner_name | recently_updated
  • text · string · requis
    Goods/services text to search for (e.g. "anti-tarnish", "vegan leather handbags"). Words of 3+ characters are matched as keywords.
  • limit · integer · optionnel
    Max rows for list_marks mode (default 20).
  • match_mode · string · optionnel · all | any
    all = every keyword must appear in the recitation (default); any = at least one.
  • nice_classes · array · optionnel
    Optional Nice class filter (e.g. [14] or ["014"]).
  • status_filter · string · optionnel · all | live | dead | registered | pending
    live = Registered + Pending; dead = Cancelled/Abandoned/Expired.
  • owner_contains · string · optionnel
    Optional: only marks whose owner name contains this text.

  Exemple d'appel

  {"name": "search_goods_services", "arguments": {"text": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_mark_statements≈ 550 tokens

  Searches the statements the USPTO records on a trademark: disclaimers ("no claim is made to PIZZA apart from the mark"), descriptions of the drawing ("the mark consists of a red and white striped awning"), translations of foreign wording, and claims of prior registrations. Answers questions such as which marks disclaim a word or which marks are described as stripes. Modes: count, top_terms, top_owners, list_marks, by_serial (every statement on one mark) and statement_types. mode=top_terms with nice_class ranks the most-disclaimed terms in a class with per-term mark counts (disclaimers only); its status filter accepts live (registered and pending together), any or dead, so a registered-only ranking is not available. A single term's registered-only count is available with mode=count, text set to the term, and status=registered. Color claims are searched with search_claimed_colors.

  Paramètres, retour & exemple (8)

  Paramètres

  • mode · string · optionnel · count | top_terms | top_owners | list_marks | by_serial | statement_types
  • text · string · optionnel
    Free text to find inside the statement, minimum 3 characters (e.g. "PIZZA", "stripe"). Omit to count every mark carrying that statement type.
  • limit · integer · optionnel
  • status · string · optionnel · any | live | dead | registered | pending
  • nice_class · string · optionnel
    Restrict to one Nice class, e.g. "25".
  • serial_number · string · optionnel
    Eight-digit serial number for mode="by_serial".
  • statement_type · string · optionnel · disclaimer | description | translation | prior_marks
    Required except for by_serial and statement_types.
  • registration_number · string · optionnel
    Registration number for mode="by_serial"; resolved to its serial number automatically.

  Exemple d'appel

  {"name": "search_mark_statements", "arguments": {"mode": "count", "text": "texte", "limit": 1, "status": "any", "nice_class": "texte", "serial_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_trademarks≈ 504 tokens

  Searches USPTO trademarks by name (14M records) and returns the closest whole-mark matches, ranked by similarity and prefix. It is not an exhaustive contains-search: multi-word marks that only contain the queried word rank low and are often cut (a KWIK query can miss KWIK REWARDS or KWIK KOPY); search_marks_by_pattern returns complete lists. A short result does not show that a name is absent from the register or available.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Maximum number of results to return
  • query · string · requis
    Search query for trademark name
  • nice_classes · array · optionnel
    Filter by Nice Classification classes (1-45)
  • status_filter · string · optionnel · all | live | dead | registered | pending
    Filter by trademark status

  Exemple d'appel

  {"name": "search_trademarks", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"query": "texte", "results": [], "total_count": 1, "open_in_gleanmark": "texte"}}

• search_ttab_proceedings≈ 506 tokens

  Search TTAB proceedings using the same discovery index as the GleanMark TTAB workspace. Use for broad proceeding discovery by party name, exact 8-digit proceeding number, 8-digit trademark serial number, or 7-digit registration number. Supports status, proceeding type, matched party role, and owner-name filters. For one known case after discovery, use get_ttab_proceeding_details; for owner enforcement statistics, use get_owner_ttab_enforcement.

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
  • query · string · requis
    Party name, 8-digit proceeding/serial number, or 7-digit registration number.
  • role_filter · array · optionnel
    Role of the party matched by query: P for plaintiff/petitioner, D for defendant/respondent.
  • type_filter · array · optionnel
    TTAB proceeding type labels (exact values from the USPTO type table). Singular forms and codes are accepted too — "Cancellation" / "CAN" → Cancellations, "Opposition" / "OPP" → Oppositions, "Extension" / "EXT" → Extensions of Time to Oppose. NOTE: Monster Energy-style enforcers file far more Oppositions than Cancellations; a Cancellations filter returning 0-1 is usually the true answer, not an error.
  • status_filter · array · optionnel
  • owner_contains · string · optionnel
    Optional additional substring that must appear in any party name.

  Exemple d'appel

  {"name": "search_ttab_proceedings", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• suggest_gs_descriptions≈ 484 tokens

  Search the USPTO Trademark ID Manual (pre-approved, surcharge-free goods & services identifications) by plain words. Call once per distinct product/service line (e.g. construction services and lighting products are two separate calls), not once per whole business. Returns selectable Term IDs; entries with {curly-brace} placeholders are fill-in templates.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Max suggestions (default 10)
  • query · string · requis
    Plain-words description of ONE product or service line (e.g. "phone cases with batteries")
  • classes · array · optionnel
    Optional Nice class filter, 1-45 (padded or unpadded, e.g. 9 or "009")
  • gs_type · string · optionnel · GOODS | SERVICES
    Optional filter to goods or services entries

  Exemple d'appel

  {"name": "suggest_gs_descriptions", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"cta": "texte", "suggestions": [], "open_in_gleanmark": "texte"}}

• validate_gs_description≈ 681 tokens

  Check a draft goods & services description against the USPTO ID Manual, clause by clause (clauses split on ";"). Each clause comes back verbatim (selectable pre-approved entry), close (with up to 3 pre-approved substitutes), or freeform (subject to the USPTO $200/class free-form surcharge). Deterministic — no AI rewriting.

  Paramètres, retour & exemple (2)

  Paramètres

  • text · string · requis
    The draft goods & services description to validate
  • classes · array · optionnel
    Optional Nice class scope, 1-45; without it exact matches may span classes

  Exemple d'appel

  {"name": "validate_gs_description", "arguments": {"text": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"clauses": [], "summary": {}, "truncated": true, "unprocessed_clause_count": 1}}

• web_research≈ 245 tokens

  Research a company, trademark, or legal topic on the internet. Returns grounded results with source citations. Use for company background, recent news, common law trademark use, or case law research.

  Paramètres, retour & exemple (4)

  Paramètres

  • mark_text · string · optionnel
    Trademark text (for common_law_use and state_registrations searches)
  • entity_name · string · requis
    Company name, trademark, or topic to research
  • nice_classes · array · optionnel
    Nice classes for context
  • research_type · string · requis · company_background | news | common_law_use | case_law | state_registrations
    Type of research to perform

  Exemple d'appel

  {"name": "web_research", "arguments": {"entity_name": "texte", "research_type": "company_background"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://gleanmark.com/mcp