MCP Server

European IP Data & Analytics — IPRATE

eu.iprate/ip-analytics

What this MCP does

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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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}}}
Added
fetch
Oct. 5, 2026, 2:44 a.m.
Added
search
Oct. 5, 2026, 2:44 a.m.
Changed
get_iprate_coverage
Oct. 5, 2026, 2:44 a.m.
Changed
get_ip_market_snapshot
Oct. 5, 2026, 2:44 a.m.
Changed
get_ip_representative_profile
Oct. 5, 2026, 2:44 a.m.
Changed
find_ip_representatives
Oct. 5, 2026, 2:44 a.m.
Added
get_iprate_coverage
Sept. 17, 2026, 12:39 p.m.
Added
get_ip_market_snapshot
Sept. 17, 2026, 12:39 p.m.
Added
get_ip_representative_profile
Sept. 17, 2026, 12:39 p.m.
Added
find_ip_representatives
Sept. 17, 2026, 12:39 p.m.