Skip to main content
Glama

docdb-mcp

An MCP server that resolves patent publication numbers to their canonical DOCDB identifiers.

What it does

Given a country code and publication number, resolve_docdb_id returns candidate records with canonical DOCDB ID (including kind code), first inventor, publication date, and family ID. This is useful for asserting that DOCDB identifiers are correct, or for recovering properly normalized DOCDB identifiers from citations that appear in different formats across documents:

  • US 8,000,000 (Greenberg) → US8000000B2

Related MCP server: mcp-fetch-patents

Installation

Option 1 — Hosted endpoint (no install)

A public MCP server is available at https://docdb.sarl-graip.fr/mcp using the streamable HTTP transport. Configure your MCP client to point at it directly:

{
  "mcpServers": {
    "docdb": {
      "type": "streamable-http",
      "url": "https://docdb.sarl-graip.fr/mcp"
    }
  }
}

No API key or credentials required.

Option 2 — Local install via uvx

Add this to your MCP client configuration (Claude Desktop, Continue, Cursor, etc.):

{
  "mcpServers": {
    "docdb": {
      "command": "uvx",
      "args": ["docdb-mcp"],
      "env": {
        "DOCDB_API_URL": "https://docdb.sarl-graip.fr"
      }
    }
  }
}

uvx installs and runs the package in one step — no virtualenv needed.

Tool reference

resolve_docdb_id(cc, number)

Parameter

Type

Description

cc

str

Two-letter DOCDB country code, e.g. "US", "EP", "WO"

number

str

Publication number without kind code, e.g. "8000000"

Strip the kind code before calling. The kind code is the trailing letter+digit suffix (B2, A1, A2, U1). Passing it returns an empty list, not an error.

"US8000000B2"  → cc="US",  number="8000000"
"EP1234567A1"  → cc="EP",  number="1234567"
"US 8,000,000" → cc="US",  number="8000000"

Returns a list of records (empty list = no match):

[
  {
    "docdb_id":  "US8000000B2",
    "inventor":  "ROBERT J. GREENBERG",
    "date_publ": "20110816",
    "family_id": "39183031"
  }
]

Multiple records mean the same publication number has several document variants (e.g. an A1 and a B2 of the same application).

License

MIT

Available Tools

1 tool
resolve_docdb_idA

Resolve a patent publication number to its canonical DOCDB record(s).

IMPORTANT — strip the kind code before calling: "US8000000B2" → cc="US", number="8000000" "EP1234567A1" → cc="EP", number="1234567" "WO2013143024" → cc="WO", number="2013143024" The kind code (trailing letter+digit suffix like B2, A1, A2, U1) is NEVER part of the number argument. Passing it causes an empty result, not an error.

Also strip formatting: "US 8,000,000" → cc="US", number="8000000".

Leading zeros in the number are ignored: "08000000" and "8000000" are equivalent.

Args: cc: Two-letter DOCDB country code, e.g. "US", "EP", "WO", "DE", "JP", "FR", "GB", "CN", "KR". Must be exactly 2 characters. number: Publication number without kind code or country prefix, digits and letters only (no hyphens, spaces, or slashes).

Returns: List of matching records, each with: - docdb_id: full DOCDB ID including kind code, e.g. "US8000000B2" - inventor: first inventor full name in caps, e.g. "ROBERT J. GREENBERG" - date_publ: publication date as YYYYMMDD, e.g. "20110816" - family_id: DOCDB patent family ID, e.g. "39183031" Multiple records mean the same publication number has several document variants (e.g. an A1 and a B2 publication of the same application). Empty list means no match — not an error.

If you get an empty list:

  1. Check that you stripped the kind code (most common mistake).

  2. Consider common transcription errors in the source material: O/0, I/1, S/5, B/8. Try plausible substitutions in the number.

  3. Use all context available to you (inventor name, year) to reconstruct the most likely number and retry.

Processing the output: The tool returns the first inventor and publication date. These map directly onto the way patents are cited in practice: "Greenberg", "Greenberg et al.", or "Greenberg et al. (2011)" in a source document should match inventor "ROBERT J. GREENBERG" and date_publ starting with "2011". Use that correspondence to verify the match. If you get multiple records, compare inventor names and publication dates across the candidates to select the most likely one. In all cases you must decide: the tool gives you candidates, not a verdict.

Error codes returned by the server (not exceptions):

  • "cc_does_not_exist": cc is not a recognized DOCDB country code — check spelling or try the ISO 2-letter code for the country.

  • "number_is_not_alnum": number contains illegal characters such as hyphens, slashes, or spaces — strip them before retrying.

Inputs: cc (required), number (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion or ambiguity between tools.

    Naming Consistency5/5

    The single tool name follows a clear verb_noun pattern (resolve_docdb_id) and is self-explanatory.

    Tool Count3/5

    A single tool is minimal but can be appropriate for a very focused purpose like patent ID resolution. However, it feels thin for any broader use case.

    Completeness3/5

    The server covers only ID resolution, missing related operations like search, listing, or batch processing. For a narrow purpose it may be sufficient, but agents have no fallback if resolution fails.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers