Wipo Pearl MCP server

@pipeworx/wipo-pearl

Scientific, technical and IP legal terminology — search a term and get back validated equivalents across 10 languages, each with a reliability rating, defining context, usage note and source. Platform key, with a small keyless fallback.

Part of Pipeworx — an MCP gateway connecting AI agents to 1843+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

— search for a term; returns matching concept records (concept id, matched term text, subject field).

• pearlsearchterms(term, sourcelanguage?, targetlanguages?, subjectfield?, abbreviation?, exactsearch?, limit?)

concept id (from pearlsearchterms): equivalents grouped by language, each with a reliability rating, defining context, usage note and source.

• pearlconcept(conceptid, lang_code?) — the full database record for one

10 language codes the other two tools accept. No arguments.

• pearlsubjectfields() — reference list of the 29 subject-field codes and

Auth

Platform key (PLATFORMWIPOKEY) with BYO override via apiKey. Unlike most platform keys, the stored value is a JSON STRING — {"clientid":"...","clientsecret":"..."} — not a bare token, because the WIPO Business Partner Portal issues an application as a clientid/secret pair rather than a single key. Each call JSON.parses it and exchanges the pair for a short-lived Bearer JWT via OAuth2 client_credentials; the token is not cached across calls.

Activation is two gates, not one — registering an application is not the same as being able to call the API. The Business Partner Portal (b2b.wipo.int) issues the clientid/clientsecret immediately on registration, but the application also has to be subscribed to the "WIPO Pearl API" product/plan, and that subscription is reviewed and approved by WIPO before it's usable — it is not instant and not guaranteed. A credential that authenticates fine at the OAuth2 token endpoint can still get a 403 from the Pearl API itself if the subscription step hasn't been approved yet; this pack's error message says exactly that rather than a generic "forbidden", so it doesn't read as our outage. If no credential (platform or BYO) is present at all, calls fall back to WIPO's own tiny keyless allowance — its own portal describes this as "5 requests per day" before you're expected to register — which is only useful for a one-off smoke test, never production traffic through a shared gateway.

Data sources

database — 250,000+ validated terms in Arabic, Chinese, English, French, German, Japanese, Korean, Portuguese, Russian and Spanish, across 29 subject fields.

• World Intellectual Property Organization (WIPO), WIPO Pearl terminology

Notes for the next person

Shortened. The full README is on GitHub.