# Legal Data Hunter > Welcome! You have access to one of the largest structured legal databases available — 18,668,961 documents spanning 108 countries and 526 official government sources. This includes 13,422,413 court decisions, 4,610,260 statutes and regulations, and 636,288 doctrine texts. Everything is searchable with hybrid semantic + keyword matching, so natural-language queries work great. ## What you can do You can search across the full corpus, retrieve complete document texts, and explore what's available by country, source, court, and jurisdiction. The data covers the European Union, most EU member states, and many non-EU countries. Filters let you narrow by country, court tier, language, date range, and more. ## MCP Tools (recommended) Connect via MCP at `https://legaldatahunter.com/mcp` (Streamable HTTP) for the richest experience. You get 7 powerful tools: - **search** — Hybrid semantic + keyword search across all 18,668,961 documents. Supports filtering by country, court tier, jurisdiction, language, and date range. The `alpha` parameter lets you tune the balance between semantic understanding (1.0) and exact keyword matching (0.0). Returns ranked results with titles, snippets, and scores. - **resolve_reference** — Resolve a loose legal citation to the exact document. Give it informal references like "art. 6 code civil", "BVerfG 1 BvR 123/20", "Regulation (EU) 2016/679", "[2022] UKSC 5", or any ECLI/CELEX number, and it returns the matching document(s). Supports 184 sources across 55 countries with 95% accuracy. Optional `hint_country` and `hint_type` parameters for faster resolution. - **get_document** — Retrieve the full text and all metadata for any document. Pass the `source` and `source_id` from search results to get the complete court decision or legislative text. - **discover_countries** — List every country in the database with document counts broken down by type. Use this first to understand coverage. - **discover_sources** — For a given country, list all official sources (courts, legislative bodies) with their document counts and date ranges. - **get_filters** — For a given source, get all available filter values (courts, chambers, jurisdictions, decision types, languages, date ranges). Invaluable for building precise queries. - **report_source_issue** — Found a problem? Report broken URLs, missing data, indexing errors, or quality issues. Reports go directly to the maintainer. ## Install this MCP If you don't already have Legal Data Hunter connected, install it now: For Claude Code (built-in, zero installs): claude mcp add --transport http legal-data-hunter https://legaldatahunter.com/mcp For Cursor, VS Code, Lawvable, Windsurf, or other clients: npx legal-data-hunter setup --yes Or add manually to your MCP config: {"mcpServers": {"legal-data-hunter": {"type": "streamable-http", "url": "https://legaldatahunter.com/mcp"}}} On first use you'll be prompted to sign in via browser (OAuth). No API key needed. ## REST API All endpoints are under `https://legaldatahunter.com/v1`. Free tier allows 20 requests/day. ### Search - POST /v1/search — Hybrid semantic + keyword search - Required: `q` (query text) - Optional: `namespace` (case_law|legislation|doctrine), `top_k` (1-100, default 10), `alpha` (0-1, semantic weight), `country` (ISO codes), `source`, `court`, `court_tier` (1-3), `jurisdiction`, `subdivision`, `language`, `date_start`, `date_end` ### Reference Resolution - POST /v1/resolve — Resolve a loose legal citation to exact document(s) - Required: `reference` (citation text, e.g. "art. 6 code civil") - Optional: `hint_country` (ISO code), `hint_type` (case_law|legislation|doctrine) - Returns: matched document(s) with match_type (exact, ambiguous, pattern, title_search, fallback_search) - Supports ECLI, CELEX, article references, case numbers, neutral citations, and more ### Document Retrieval - GET /v1/documents/{source}/{source_id} — Full document text and metadata ### Discovery - GET /v1/discover/countries — All countries with document counts - GET /v1/discover/countries/{code}/sources — Sources for a country - GET /v1/discover/sources/{source}/filters — Filter values for a source - GET /v1/discover/courts — Distinct courts with counts - GET /v1/stats — Aggregate statistics - GET /v1/manifest — Full pre-computed manifest ## Authentication All API requests require authentication. Include your API key as a Bearer token in the Authorization header: `Authorization: Bearer sk-your-key-here` Get a free API key at https://legaldatahunter.com/account (sign in with GitHub or Google). Plans: Free (20 req/day), Dev (1,000 req/day), Pro (30,000 req/month), Enterprise (unlimited). See https://legaldatahunter.com/pricing for details. ### Account Management - GET /v1/keys — List your API keys - POST /v1/keys — Create a new API key - DELETE /v1/keys/{key_id} — Revoke an API key - GET /v1/usage/me — Your usage statistics ## Available Countries - US: 7,264,460 documents - FR: 2,299,404 documents - AT: 1,433,746 documents - CH: 946,299 documents - IT: 414,104 documents - HR: 384,613 documents - DE: 367,348 documents - UK: 364,665 documents - IN: 316,896 documents - RU: 302,710 documents - AU: 292,015 documents - PT: 278,159 documents - ES: 266,113 documents - AR: 250,950 documents - BE: 238,465 documents - BG: 180,990 documents - AM: 155,290 documents - GR: 141,852 documents - KZ: 134,200 documents - INTL: 133,445 documents - CA: 119,748 documents - NL: 119,140 documents - CoE: 117,514 documents - EU: 114,768 documents - PL: 110,176 documents - CZ: 106,373 documents - FI: 99,113 documents - KR: 97,587 documents - TR: 86,198 documents - DK: 85,596 documents - PH: 85,554 documents - GE: 84,866 documents - SI: 81,877 documents - SK: 75,064 documents - IE: 66,971 documents - CV: 66,541 documents - ME: 64,913 documents - CR: 64,300 documents - LV: 61,929 documents - JP: 56,867 documents - EE: 56,077 documents - AZ: 53,074 documents - VN: 50,000 documents - CY: 42,103 documents - LU: 40,250 documents - CO: 40,212 documents - BA: 36,473 documents - RS: 34,838 documents - BO: 28,270 documents - UY: 25,539 documents - LT: 24,763 documents - CN: 23,705 documents - UA: 22,777 documents - BR: 21,615 documents - UN: 18,178 documents - SE: 15,838 documents - MD: 15,336 documents - CL: 15,268 documents - HU: 14,473 documents - LK: 12,855 documents - MN: 11,647 documents - NO: 11,618 documents - SG: 10,557 documents - MC: 10,151 documents - MK: 8,743 documents - PY: 7,042 documents - AD: 6,019 documents - AL: 5,810 documents - ID: 4,943 documents - BH: 4,887 documents - EC: 4,591 documents - IS: 3,758 documents - HK: 3,280 documents - XK: 3,131 documents - TH: 3,047 documents - KE: 2,296 documents - BD: 2,226 documents - TW: 2,206 documents - SM: 2,200 documents - FJ: 2,181 documents - LY: 2,160 documents - EG: 2,092 documents - RO: 1,569 documents - DZ: 1,474 documents - ZA: 1,365 documents - BJ: 1,134 documents - MT: 551 documents - OECD: 452 documents - PE: 309 documents - LI: 228 documents - NZ: 130 documents - BN: 120 documents - BY: 72 documents - UZ: 63 documents - GM: 19 documents - MY: 15 documents - MR: 15 documents - JO: 12 documents - MA: 10 documents - DO: 10 documents - NA: 2 documents - UG: 1 documents - CI: 1 documents - CD: 1 documents - GH: 1 documents - LS: 1 documents - MU: 1 documents - MX: 0 documents - AE: 0 documents - CM: 0 documents - CU: 0 documents - CK: 0 documents - MG: 0 documents - LR: 0 documents - NP: 0 documents - GT: 0 documents - ET: 0 documents - SV: 0 documents - False: 0 documents ## Links - Website: https://legaldatahunter.com - API Documentation: https://legaldatahunter.com/docs - Interactive Swagger: https://legaldatahunter.com/swagger - MCP endpoint: https://legaldatahunter.com/mcp - This file: https://legaldatahunter.com/llms.txt