# Legal Data Hunter > Welcome! You have access to one of the largest structured legal databases available — 40,830,317 documents spanning 236 countries and 1857 official government sources. This includes 31,406,883 court decisions, 7,464,883 statutes and regulations, and 1,958,551 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 40,830,317 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: 18,690,062 documents - FR: 2,932,585 documents - LT: 1,710,924 documents - AT: 1,569,237 documents - BR: 1,426,893 documents - IN: 1,203,870 documents - CH: 1,102,651 documents - DE: 795,628 documents - INTL: 720,119 documents - RU: 595,418 documents - IT: 458,265 documents - UK: 455,477 documents - ME: 424,266 documents - HR: 400,972 documents - ES: 400,495 documents - MX: 387,996 documents - AU: 332,100 documents - AR: 320,983 documents - UN: 302,226 documents - PT: 298,156 documents - BE: 248,911 documents - BG: 238,152 documents - RO: 234,491 documents - KG: 229,086 documents - TH: 225,879 documents - KR: 219,592 documents - FI: 196,917 documents - EU: 196,649 documents - CA: 188,957 documents - NL: 188,690 documents - AM: 156,446 documents - GE: 152,692 documents - LV: 150,123 documents - GR: 143,767 documents - DK: 141,886 documents - KZ: 138,752 documents - CO: 135,270 documents - PL: 133,542 documents - CZ: 130,980 documents - CoE: 128,964 documents - PH: 116,214 documents - UA: 115,042 documents - TR: 110,912 documents - LU: 98,213 documents - HU: 97,706 documents - IE: 95,947 documents - SI: 94,258 documents - SK: 75,188 documents - CR: 71,835 documents - CV: 67,811 documents - RS: 65,157 documents - GT: 64,963 documents - CY: 64,847 documents - JP: 61,603 documents - DJ: 57,008 documents - EE: 56,826 documents - VN: 53,593 documents - AZ: 53,175 documents - NI: 50,768 documents - DO: 49,383 documents - MC: 47,752 documents - CL: 41,009 documents - UY: 39,143 documents - BA: 37,747 documents - CN: 37,703 documents - PK: 36,662 documents - MO: 34,072 documents - PE: 33,597 documents - OM: 31,309 documents - BO: 28,270 documents - NO: 27,979 documents - TW: 27,800 documents - NZ: 24,299 documents - BH: 22,750 documents - SG: 22,297 documents - PA: 20,757 documents - CI: 18,383 documents - MD: 18,184 documents - IS: 17,451 documents - SE: 17,214 documents - PY: 14,944 documents - AO: 14,634 documents - EC: 14,615 documents - SN: 13,853 documents - ZA: 13,840 documents - LK: 13,788 documents - SV: 13,785 documents - BJ: 13,640 documents - CW: 13,367 documents - PS: 13,135 documents - ID: 12,198 documents - MN: 11,871 documents - MU: 11,852 documents - TG: 10,876 documents - NR: 10,087 documents - MP: 9,496 documents - UZ: 9,121 documents - MK: 9,077 documents - MG: 7,428 documents - AW: 7,370 documents - FO: 7,363 documents - FM: 7,199 documents - JO: 6,798 documents - SR: 6,734 documents - AL: 6,265 documents - AD: 6,089 documents - BD: 5,947 documents - IM: 5,790 documents - SA: 5,636 documents - KH: 5,256 documents - HK: 5,251 documents - TZ: 5,200 documents - AE: 5,193 documents - DZ: 5,025 documents - PR: 4,975 documents - QA: 4,909 documents - KE: 4,176 documents - MT: 4,031 documents - LI: 3,997 documents - BS: 3,756 documents - HT: 3,650 documents - BM: 3,635 documents - VA: 3,394 documents - MY: 3,210 documents - TN: 3,200 documents - XK: 3,181 documents - AG: 3,175 documents - BZ: 3,037 documents - GU: 3,033 documents - CU: 2,865 documents - FJ: 2,705 documents - BN: 2,698 documents - ZM: 2,502 documents - EG: 2,497 documents - HN: 2,459 documents - LY: 2,287 documents - SM: 2,240 documents - TO: 2,216 documents - TC: 2,197 documents - JE: 2,036 documents - CM: 2,026 documents - SX: 2,013 documents - GA: 1,910 documents - BB: 1,904 documents - LC: 1,894 documents - MA: 1,884 documents - GH: 1,863 documents - NA: 1,835 documents - NG: 1,782 documents - ET: 1,760 documents - MS: 1,737 documents - BW: 1,585 documents - IL: 1,506 documents - BQ: 1,408 documents - KY: 1,408 documents - GN: 1,379 documents - ML: 1,288 documents - SC: 1,189 documents - MM: 1,180 documents - RW: 1,075 documents - ZW: 1,066 documents - MZ: 1,059 documents - AI: 1,045 documents - KN: 1,036 documents - FK: 1,009 documents - CG: 990 documents - VG: 970 documents - VI: 965 documents - JM: 964 documents - CD: 962 documents - PM: 908 documents - NE: 901 documents - SO: 889 documents - TL: 881 documents - TT: 860 documents - GI: 838 documents - VU: 811 documents - LS: 779 documents - TJ: 752 documents - LB: 734 documents - SB: 716 documents - IQ: 689 documents - PF: 639 documents - GG: 606 documents - SL: 589 documents - MV: 570 documents - VE: 568 documents - MH: 538 documents - AX: 517 documents - LR: 507 documents - GD: 488 documents - VC: 478 documents - TD: 464 documents - OECD: 452 documents - SY: 450 documents - BF: 435 documents - MW: 424 documents - WS: 422 documents - TM: 413 documents - UG: 407 documents - NP: 396 documents - SZ: 382 documents - YE: 361 documents - CK: 357 documents - SH: 332 documents - BT: 326 documents - KW: 185 documents - NU: 184 documents - NC: 182 documents - GY: 181 documents - MR: 154 documents - DM: 152 documents - GQ: 145 documents - SD: 144 documents - KM: 132 documents - GL: 121 documents - MF: 115 documents - IR: 114 documents - BL: 101 documents - SS: 96 documents - LA: 95 documents - BY: 72 documents - GM: 60 documents - BI: 54 documents - CF: 53 documents - PG: 44 documents - WF: 40 documents - AF: 35 documents - GW: 34 documents - KP: 25 documents - TV: 23 documents - KI: 21 documents - AS: 20 documents - ER: 15 documents - PW: 15 documents - NF: 0 documents - PN: 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