`echr_judgment`

Pack: hudoc · Endpoint: https://gateway.pipeworx.io/hudoc/mcp

Fetch the full text of one ECHR document by its itemid (from echr_search, e.g. “001-249132”). Returns the judgment/decision body converted to plain text, paged. Very recently published items (within a few days) sometimes have no converted text yet — the tool says so rather than returning nothing silently; echr_search’s conclusion field is available immediately even then.

Parameters

Name	Type	Required	Description
`itemid`	string	yes	HUDOC itemid from echr_search, e.g. “001-249132”.
`max_chars`	number	no	Max characters to return (default 12000, max 40000).
`offset`	number	no	Character offset, for paging through a long judgment (default 0).

Example call

Arguments

{
  "itemid": "001-249132"
}

curl

curl -X POST https://gateway.pipeworx.io/hudoc/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"echr_judgment","arguments":{"itemid":"001-249132"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('echr_judgment', {
  "itemid": "001-249132"
});

Response shape

Always returns: itemid, found, citation_url

Field	Type	Description
`itemid`	string	The HUDOC document id requested.
`found`	boolean	Whether converted full text was available. False is a normal outcome for very recently published documents, not an error.
`total_chars`	number	Total length of the whole document in characters (present when found).
`offset`	number	Character offset this slice starts at (present when found).
`returned_chars`	number	Length of the text slice returned (present when found).
`has_more`	boolean	Whether text remains beyond this slice (present when found).
`next_offset`	number \| null	Offset to pass back to read the next slice, or null at the end of the document (present when found).
`text`	string	Plain-text slice of the judgment, converted from HUDOC’s DOCX-to-HTML endpoint (present when found).
`reason`	string	Why no text was returned (present only when found is false).
`message`	string	Plain-English explanation of the miss and what to do instead (present only when found is false).
`citation_url`	string	Public hudoc.echr.coe.int URL for the document.
`source`	string	Attribution string for the HUDOC database (present when found).

Full JSON Schema

{
  "type": "object",
  "properties": {
    "itemid": {
      "type": "string",
      "description": "The HUDOC document id requested."
    },
    "found": {
      "type": "boolean",
      "description": "Whether converted full text was available. False is a normal outcome for very recently published documents, not an error."
    },
    "total_chars": {
      "type": "number",
      "description": "Total length of the whole document in characters (present when found)."
    },
    "offset": {
      "type": "number",
      "description": "Character offset this slice starts at (present when found)."
    },
    "returned_chars": {
      "type": "number",
      "description": "Length of the text slice returned (present when found)."
    },
    "has_more": {
      "type": "boolean",
      "description": "Whether text remains beyond this slice (present when found)."
    },
    "next_offset": {
      "type": [
        "number",
        "null"
      ],
      "description": "Offset to pass back to read the next slice, or null at the end of the document (present when found)."
    },
    "text": {
      "type": "string",
      "description": "Plain-text slice of the judgment, converted from HUDOC's DOCX-to-HTML endpoint (present when found)."
    },
    "reason": {
      "type": "string",
      "enum": [
        "not_yet_converted",
        "empty_body"
      ],
      "description": "Why no text was returned (present only when found is false)."
    },
    "message": {
      "type": "string",
      "description": "Plain-English explanation of the miss and what to do instead (present only when found is false)."
    },
    "citation_url": {
      "type": "string",
      "description": "Public hudoc.echr.coe.int URL for the document."
    },
    "source": {
      "type": "string",
      "description": "Attribution string for the HUDOC database (present when found)."
    }
  },
  "required": [
    "itemid",
    "found",
    "citation_url"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "hudoc": {
      "url": "https://gateway.pipeworx.io/hudoc/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

echr_judgment