Serveur MCP

European IP Data & Analytics — IPRATE

eu.iprate/ip-analytics

Ce que fait ce MCP

Searches published European intellectual-property representative profiles, provides bounded evidence profiles, and returns static market snapshots and coverage information.

fetch
Fetch one IPRATE evidence document
Use this after search to read one document in full: a published representative profile with its released ratings, a market snapshot with released statistics and leading firms, or a coverage summary. Returns the text, the public URL to cite, and release metadata.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 300, 'description': 'Document id returned by search, such as firm:<slug> or market:LT:trademark:national:long.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['id', 'title', 'text', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'description': 'Public IPRATE page to cite.'}, 'text': {'type': 'string', 'description': 'Full document text.'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'properties': {'as_of': {'type': 'string'}, 'release_id': {'type': 'string'}, 'methodology': {'type': 'string'}, 'data_sources': {'type': 'string'}, 'document_type': {'type': 'string'}}}}}
find_ip_representatives
Find published IP representatives
Find up to five firms or attorneys from the selected static release. Use this for a name, jurisdiction, right type, released leading Nice class, or released leading-client match. At least one filter is required.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'name': {'type': 'string', 'maxLength': 256, 'description': 'Representative name fragment, matched against released profile identities.'}, 'tier': {'enum': ['national', 'euro'], 'type': 'string', 'description': 'Optional released national or European route.'}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 5, 'minimum': 1, 'description': 'Maximum results; hard maximum five.'}, 'window': {'enum': ['long', 'recent'], 'type': 'string', 'description': 'Optional released long or recent analytical window.'}, 'right_type': {'enum': ['trademark', 'design', 'patent'], 'type': 'string', 'description': 'IP right type.'}, 'client_name': {'type': 'string', 'maxLength': 256, 'description': 'Named client to match against leading-client evidence already public on profiles.'}, 'jurisdiction': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 jurisdiction code, or EU for the European route.'}, 'nice_classes': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5, 'description': 'One to five Nice class numbers; trademark only.'}, 'representative_type': {'enum': ['firm', 'attorney', 'both'], 'type': 'string', 'default': 'both', 'description': 'Return firms, attorneys, or both.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['status', 'data', 'as_of', 'release_id', 'coverage', 'limitations', 'source_urls', 'links', 'server_version'], 'properties': {'data': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'city': {'type': ['string', 'null']}, 'profile_url': {'type': 'string'}, 'quoted_name': {'type': ['string', 'null']}, 'matching_cohort': {'type': 'object', 'properties': {'tier': {'type': 'string'}, 'window': {'type': 'string'}, 'right_type': {'type': 'string'}, 'top_classes': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'share_pct': {'type': ['number', 'null']}, 'class_code': {'type': ['string', 'number', 'null']}, 'class_label': {'type': ['string', 'null']}}}}, 'jurisdiction': {'type': 'string'}, 'leading_clients': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'share_pct': {'type': ['number', 'null']}, 'quoted_name': {'type': ['string', 'null']}}}}, 'published_rating': {'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'tier': {'type': ['string', 'null']}, 'score': {'type': ['number', 'null']}, 'confidence': {'type': ['string', 'null']}}, 'description': 'Rating copied from the release: score, tier code (Q1 Elite to Q4 Select), confidence grade, rank.'}, 'released_activity': {'type': 'object', 'properties': {'case_units': {'type': ['number', 'null']}, 'volume_per_year': {'type': ['number', 'null']}, 'registration_rate': {'type': ['number', 'null']}, 'time_to_grant_days': {'type': ['number', 'null']}, 'total_firms_filing': {'type': ['number', 'null']}}}}}, 'text_provenance': {'type': 'string'}, 'home_country_code': {'type': ['string', 'null']}, 'representative_id': {'type': 'number'}, 'representative_type': {'type': 'string'}}}}, 'message': {'type': 'string', 'description': 'Explanation when status is not ok.'}}, 'description': 'Tool result. Which fields are present depends on status.'}, 'as_of': {'type': ['string', 'null'], 'description': 'Generation time of the selected static release.'}, 'links': {'type': 'object', 'properties': {'explore': {'type': 'string'}, 'methodology': {'type': 'string'}, 'request_analysis': {'type': 'string'}}}, 'status': {'enum': ['ok', 'no_results', 'ambiguous', 'not_public', 'not_covered', 'source_unavailable', 'invalid_request'], 'type': 'string'}, 'coverage': {'type': 'object', 'properties': {'tier': {'type': ['string', 'null']}, 'error_type': {'type': 'string'}, 'exclusions': {'type': 'array', 'items': {'type': 'string'}}, 'hold_state': {'type': 'string'}, 'right_type': {'type': ['string', 'null']}, 'availability': {'type': 'string'}, 'jurisdiction': {'type': ['string', 'null']}, 'static_assets': {'type': 'array', 'items': {'type': 'string'}}}}, 'release_id': {'type': ['string', 'null']}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'source_urls': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public URLs to cite.'}, 'server_version': {'type': 'string'}}}
get_ip_market_snapshot
Get a European IP market snapshot
Return one already-computed static cohort snapshot and up to five leading released firms. No dates, raw records, SQL, arbitrary grouping, or free-form question are accepted.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['jurisdiction', 'right_type', 'tier', 'window'], 'properties': {'tier': {'enum': ['national', 'euro'], 'type': 'string', 'description': 'Released national or European route.'}, 'window': {'enum': ['long', 'recent'], 'type': 'string', 'description': 'Released long or recent analytical window.'}, 'right_type': {'enum': ['trademark', 'design', 'patent'], 'type': 'string', 'description': 'IP right type.'}, 'jurisdiction': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 jurisdiction code.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['status', 'data', 'as_of', 'release_id', 'coverage', 'limitations', 'source_urls', 'links', 'server_version'], 'properties': {'data': {'type': 'object', 'properties': {'tier': {'type': 'string'}, 'window': {'type': 'string'}, 'message': {'type': 'string', 'description': 'Explanation when status is not ok.'}, 'right_type': {'type': 'string'}, 'jurisdiction': {'type': 'string'}, 'released_statistics': {'type': 'object'}, 'leading_representatives': {'type': 'array', 'items': {'type': 'object', 'properties': {'city': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'top_class': {'type': ['string', 'number', 'null']}, 'score_tier': {'type': ['string', 'null']}, 'profile_url': {'type': 'string'}, 'quoted_name': {'type': ['string', 'null']}, 'volume_per_year': {'type': ['number', 'null']}, 'confidence_grade': {'type': ['string', 'null']}, 'home_country_code': {'type': ['string', 'null']}, 'registration_rate': {'type': ['number', 'null']}, 'representative_id': {'type': ['number', 'null']}, 'time_to_grant_days': {'type': ['number', 'null']}}}}}, 'description': 'Tool result. Which fields are present depends on status.'}, 'as_of': {'type': ['string', 'null'], 'description': 'Generation time of the selected static release.'}, 'links': {'type': 'object', 'properties': {'explore': {'type': 'string'}, 'methodology': {'type': 'string'}, 'request_analysis': {'type': 'string'}}}, 'status': {'enum': ['ok', 'no_results', 'ambiguous', 'not_public', 'not_covered', 'source_unavailable', 'invalid_request'], 'type': 'string'}, 'coverage': {'type': 'object', 'properties': {'tier': {'type': ['string', 'null']}, 'error_type': {'type': 'string'}, 'exclusions': {'type': 'array', 'items': {'type': 'string'}}, 'hold_state': {'type': 'string'}, 'right_type': {'type': ['string', 'null']}, 'availability': {'type': 'string'}, 'jurisdiction': {'type': ['string', 'null']}, 'static_assets': {'type': 'array', 'items': {'type': 'string'}}}}, 'release_id': {'type': ['string', 'null']}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'source_urls': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public URLs to cite.'}, 'server_version': {'type': 'string'}}}
get_iprate_coverage
Check IPRATE data coverage
Explain which static release cohorts support a jurisdiction and IP-right question. Returns held, partial, or not-covered state, release assets, counts, and supported fields.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'tier': {'enum': ['national', 'euro'], 'type': 'string', 'description': 'Optional released national or European route.'}, 'right_type': {'enum': ['trademark', 'design', 'patent'], 'type': 'string', 'description': 'Optional IP right type.'}, 'jurisdiction': {'type': 'string', 'description': 'Optional ISO 3166-1 alpha-2 code, or EU for the European route.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['status', 'data', 'as_of', 'release_id', 'coverage', 'limitations', 'source_urls', 'links', 'server_version'], 'properties': {'data': {'type': 'object', 'properties': {'cohorts': {'type': 'array', 'items': {'type': 'object', 'properties': {'tier': {'type': 'string'}, 'run_id': {'type': ['number', 'null']}, 'status': {'type': 'string'}, 'windows': {'type': 'array', 'items': {'type': 'string'}}, 'right_type': {'type': 'string'}, 'jurisdiction': {'type': 'string'}, 'published_at': {'type': ['string', 'null']}}}}, 'message': {'type': 'string', 'description': 'Explanation when status is not ok.'}, 'holdings': {'type': 'object'}, 'hold_state': {'type': 'string'}, 'supported_field_groups': {'type': 'array', 'items': {'type': 'string'}}, 'published_profile_counts': {'type': 'object'}}, 'description': 'Tool result. Which fields are present depends on status.'}, 'as_of': {'type': ['string', 'null'], 'description': 'Generation time of the selected static release.'}, 'links': {'type': 'object', 'properties': {'explore': {'type': 'string'}, 'methodology': {'type': 'string'}, 'request_analysis': {'type': 'string'}}}, 'status': {'enum': ['ok', 'no_results', 'ambiguous', 'not_public', 'not_covered', 'source_unavailable', 'invalid_request'], 'type': 'string'}, 'coverage': {'type': 'object', 'properties': {'tier': {'type': ['string', 'null']}, 'error_type': {'type': 'string'}, 'exclusions': {'type': 'array', 'items': {'type': 'string'}}, 'hold_state': {'type': 'string'}, 'right_type': {'type': ['string', 'null']}, 'availability': {'type': 'string'}, 'jurisdiction': {'type': ['string', 'null']}, 'static_assets': {'type': 'array', 'items': {'type': 'string'}}}}, 'release_id': {'type': ['string', 'null']}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'source_urls': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public URLs to cite.'}, 'server_version': {'type': 'string'}}}
get_ip_representative_profile
Get a public representative evidence profile
Return the bounded public evidence profile for one published IP firm or attorney. Provide exactly one numeric representative_id or public profile slug.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'slug': {'type': 'string', 'maxLength': 256, 'description': 'Exact public IPRATE profile slug.'}, 'representative_id': {'type': 'integer', 'minimum': 1, 'description': 'Published representative numeric ID.'}, 'representative_type': {'enum': ['firm', 'attorney'], 'type': 'string', 'description': 'Disambiguates an identifier shared by firm and attorney profiles.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['status', 'data', 'as_of', 'release_id', 'coverage', 'limitations', 'source_urls', 'links', 'server_version'], 'properties': {'data': {'type': 'object', 'properties': {'city': {'type': ['string', 'null']}, 'slug': {'type': 'string'}, 'message': {'type': 'string', 'description': 'Explanation when status is not ok.'}, 'profile_url': {'type': 'string'}, 'quoted_name': {'type': ['string', 'null']}, 'candidate_types': {'type': 'array', 'items': {'type': 'string'}}, 'text_provenance': {'type': 'string'}, 'released_cohorts': {'type': 'array', 'items': {'type': 'object', 'properties': {'tier': {'type': 'string'}, 'window': {'type': 'string'}, 'right_type': {'type': 'string'}, 'top_classes': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'share_pct': {'type': ['number', 'null']}, 'class_code': {'type': ['string', 'number', 'null']}, 'class_label': {'type': ['string', 'null']}}}}, 'jurisdiction': {'type': 'string'}, 'leading_clients': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'share_pct': {'type': ['number', 'null']}, 'quoted_name': {'type': ['string', 'null']}}}}, 'published_rating': {'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'tier': {'type': ['string', 'null']}, 'score': {'type': ['number', 'null']}, 'confidence': {'type': ['string', 'null']}}, 'description': 'Rating copied from the release: score, tier code (Q1 Elite to Q4 Select), confidence grade, rank.'}, 'released_activity': {'type': 'object', 'properties': {'case_units': {'type': ['number', 'null']}, 'volume_per_year': {'type': ['number', 'null']}, 'registration_rate': {'type': ['number', 'null']}, 'time_to_grant_days': {'type': ['number', 'null']}, 'total_firms_filing': {'type': ['number', 'null']}}}}}}, 'home_country_code': {'type': ['string', 'null']}, 'representative_id': {'type': 'number'}, 'representative_type': {'type': 'string'}}, 'description': 'Tool result. Which fields are present depends on status.'}, 'as_of': {'type': ['string', 'null'], 'description': 'Generation time of the selected static release.'}, 'links': {'type': 'object', 'properties': {'explore': {'type': 'string'}, 'methodology': {'type': 'string'}, 'request_analysis': {'type': 'string'}}}, 'status': {'enum': ['ok', 'no_results', 'ambiguous', 'not_public', 'not_covered', 'source_unavailable', 'invalid_request'], 'type': 'string'}, 'coverage': {'type': 'object', 'properties': {'tier': {'type': ['string', 'null']}, 'error_type': {'type': 'string'}, 'exclusions': {'type': 'array', 'items': {'type': 'string'}}, 'hold_state': {'type': 'string'}, 'right_type': {'type': ['string', 'null']}, 'availability': {'type': 'string'}, 'jurisdiction': {'type': ['string', 'null']}, 'static_assets': {'type': 'array', 'items': {'type': 'string'}}}}, 'release_id': {'type': ['string', 'null']}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'source_urls': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Public URLs to cite.'}, 'server_version': {'type': 'string'}}}
search
Search IPRATE published evidence
Use this for open research about European IP firms, IP attorneys, or an IP market, such as who leads trademark work in a country or what IPRATE publishes about a named firm. Returns up to ten documents (representative profiles, market snapshots, coverage summaries) with ids for fetch and public URLs to cite. It searches one completed static IPRATE release, not the official registers; a missing result does not prove that a representative does not exist.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 256, 'description': "Free text: a firm or attorney name, a country, an IP right type (trademark, design, patent), or a combination such as 'patent firms Germany'."}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string', 'description': 'Document id to pass to fetch.'}, 'url': {'type': 'string', 'description': 'Public IPRATE page to cite.'}, 'title': {'type': 'string'}}}, 'maxItems': 10}}}
Ajouté
fetch
5 October 2026 02:44
Ajouté
search
5 October 2026 02:44
Modifié
get_iprate_coverage
5 October 2026 02:44
Modifié
get_ip_market_snapshot
5 October 2026 02:44
Modifié
get_ip_representative_profile
5 October 2026 02:44
Modifié
find_ip_representatives
5 October 2026 02:44
Ajouté
get_iprate_coverage
17 September 2026 12:39
Ajouté
get_ip_market_snapshot
17 September 2026 12:39
Ajouté
get_ip_representative_profile
17 September 2026 12:39
Ajouté
find_ip_representatives
17 September 2026 12:39