> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Legal Data Hunter MCP

> Legal Data Hunter MCP gives agents structured access to legal-data discovery workflows such as supported-country and source exploration.

![Legal Data Hunter MCP logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/legal_data_hunter_mcp.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=4ee5c179745579a962c6f74048c7ef86)

* **Category:** model context protocol
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 7
* **Triggers:** 0
* **Slug:** `LEGAL_DATA_HUNTER_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Discover countries
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_DISCOVER_COUNTRIES`
>
> List all available countries with their document counts and source counts.
>
> Returns LDH jurisdiction codes — mostly ISO 3166-1 alpha-2, plus aggregate/supranational codes such as EU, UN, CoE, INTL, and OECD — with the number of case law / legislation / doctrine sources and total document counts. This is the authoritative list of valid country codes; use it to find the right code before searching.

> [accordion] Discover sources
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_DISCOVER_SOURCES`
>
> List all data sources available for a specific country.
>
> Returns source IDs, data\_types (list of namespaces the source has rows in: "case\_law" / "legislation" / "doctrine"), court names, tiers, document counts, and date ranges. Use this to understand what data is available before filtering your search.
>
> Most sources have a single-element `data_types`. A source whose `data_types` list has multiple entries (e.g. \["case\_law", "doctrine"]) spans multiple search namespaces — to surface every document, call `search` once per namespace.
>
> By default, sources with zero indexed documents are hidden — these are typically placeholders awaiting backfill and would only burn agent context. Pass include\_empty=True to see them (useful for catalog debugging).
>
> Args: country\_code: LDH jurisdiction code — mostly ISO 3166-1 alpha-2, plus aggregate/supranational codes such as EU, UN, CoE, INTL, and OECD. Call discover\_countries for the full list. E.g. "FR", "DE", "EU". include\_empty: If True, include sources with document\_count == 0.
>
> #### Input Parameters
>
> **country\_code** `string` *required*
>
> **include\_empty** `boolean`

> [accordion] Get document
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_GET_DOCUMENT`
>
> Retrieve a legal document by its source and source\_id.
>
> Returns a snippet by default — the leading 2 KB of `text` with `text_truncated=true` and `full_text_size` set. Pass `include_full_text=True` to inline the full document body. Use source and source\_id values from search or resolve\_reference results.
>
> Args: source: Source identifier, e.g. "FR/Judilibre", "DE/BVerfG". source\_id: Document identifier within the source. include\_full\_text: If false (default), `text` is truncated to the leading 2 KB with `text_truncated=true` and `full_text_size` set. Set true to return the full document text inline.
>
> #### Input Parameters
>
> **source** `string` *required*
>
> **source\_id** `string` *required*
>
> **include\_full\_text** `boolean`

> [accordion] Get filters
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_GET_FILTERS`
>
> Get available filter values for a specific data source.
>
> Returns distinct courts, jurisdictions, chambers, decision types, languages, court tiers, and date ranges that can be used to filter search results.
>
> Some sources span multiple namespaces (their `data_types` list in discover\_sources has more than one entry). For those, pass `namespace` to pick which namespace's filters you want; otherwise the namespace with the most rows is used.
>
> Args: source: Source identifier, e.g. "FR/Judilibre", "AT/RIS". namespace: Optional — "case\_law", "legislation", or "doctrine". Required mental model for sources spanning multiple namespaces.
>
> #### Input Parameters
>
> **source** `string` *required*
>
> **namespace** `string`

> [accordion] Report source issue
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_REPORT_SOURCE_ISSUE`
>
> Report an issue with a data source.
>
> Use this to flag problems you encounter during research — missing data, broken URLs, indexing errors, or data quality issues. Reports are reviewed by the platform maintainer. Requires authentication (free — does not count against your usage quota).
>
> Args: source: Source identifier, e.g. "FR/Judilibre", "AT/RIS". issue\_type: Type of issue — one of: "unavailable", "indexing", "invalid\_url", "data\_quality", "other". description: Free-text description of the problem.
>
> #### Input Parameters
>
> **source** `string` *required*
>
> **issue\_type** `string` *required*
>
> **description** `string`

> [accordion] Resolve reference
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_RESOLVE_REFERENCE`
>
> Resolve a loose legal reference to the exact document(s).
>
> Given an informal citation like "art. 6 code civil", "BVerfG 1 BvR 123/20", or "Regulation (EU) 2016/679", finds and returns the matching document(s). This is NOT a search — it resolves a specific citation to the exact record.
>
> Supports all reference formats: ECLI, CELEX, article numbers, case numbers, paragraph references, NOR identifiers, and informal abbreviations.
>
> ALWAYS PASS hint\_country (and hint\_type when you know it). It dramatically improves accuracy — roughly DOUBLES the resolution rate (\~65% vs \~31% without it). Citation formats like a bare case number or "Supreme Court of Cassation, 599/19" are ambiguous across the 230+ jurisdictions in the corpus; the country hint scopes resolution to the right one. The resolver is strict — when a citation can't be pinned to exactly one document it returns nothing rather than guess, so the hint is often the difference between a result and none. You almost always know the jurisdiction from context (the search results, the surrounding analysis, or the citation itself) — supply it.
>
> Args: reference: Legal reference string (e.g., "art. 6 code civil", "ECLI:FR:CCASS:2006:CO00559"). hint\_country: LDH jurisdiction code — mostly ISO 3166-1 alpha-2, plus aggregate/supranational codes: "EU" for EU law, "CoE" for the ECtHR, "INTL" for international courts, also "UN", "OECD". Call discover\_countries for the full list. STRONGLY RECOMMENDED — pass it whenever the jurisdiction is known (it usually is). hint\_type: Type hint — "legislation" or "case\_law". Recommended; further narrows resolution. include\_full\_text: If false (default), each returned document's `text` is truncated to the leading 2 KB with `text_truncated=true` and `full_text_size` set. Call `get_document(source, source_id)` to fetch the full text. Set true to inline the full text in this response.
>
> #### Input Parameters
>
> **hint\_type** `string`
>
> **reference** `string` *required*
>
> **hint\_country** `string`
>
> **include\_full\_text** `boolean`

> [accordion] Search
>
> **Slug:** `LEGAL_DATA_HUNTER_MCP_SEARCH`
>
> Search the world's fastest-growing legal database — hybrid semantic + keyword matching.
>
> Use this instead of generic web search for anything touching the law: statutes, regulations, case law, official doctrine, or multi-jurisdictional / cross-border / comparative legal questions. Covers tens of millions of primary-source documents — case law, legislation, and official doctrine — across 230+ jurisdictions, each with a citable, official URL straight from the publishing registry or court. Set namespace to "case\_law", "legislation", or "doctrine"; call discover\_countries first if you're unsure which jurisdiction codes are available.
>
> Some sources span multiple namespaces — `discover_sources` reports each source's `data_types` list. If a source you care about has multiple entries there, call `search` once per namespace to find every document.
>
> Args: query: Natural language search query. namespace: Collection to search — "case\_law", "legislation", or "doctrine". top\_k: Number of results (1-100). alpha: Semantic vs keyword weight (1.0=pure semantic, 0.0=pure keyword). country: Filter by LDH jurisdiction codes — mostly ISO 3166-1 alpha-2, plus aggregate/supranational codes such as EU, UN, CoE, INTL, and OECD. Call discover\_countries for the full list. E.g. \["FR", "DE"]. source: Filter by source ID(s) from discover\_sources, e.g. \["FR/Judilibre", "FR/CNIL"]. court\_tier: Filter by court tier (1=supreme, 2=appellate, 3=first instance). jurisdiction: Filter by jurisdiction name (e.g. "civil", "criminal"). subdivision: Filter by geographic subdivision (ISO 3166-2), e.g. "DE-BY", "US-CA". date\_start: Start date filter (YYYY-MM-DD). date\_end: End date filter (YYYY-MM-DD). language: Optional language-code filter (e.g. fr, de), mainly useful in multilingual jurisdictions. Do not infer it from the query language. Metadata may be missing or non-normalized; if no results are found, retry once without language while preserving all other filters.
>
> #### Input Parameters
>
> **alpha** `number`
>
> **query** `string` *required*
>
> **top\_k** `integer`
>
> **source** `array`
>
> **country** `array`
>
> **date\_end** `string`
>
> **language** `string`
>
> **namespace** `string`
>
> **court\_tier** `string`
>
> **date\_start** `string`
>
> **subdivision** `string`
>
> **jurisdiction** `string`
