# Legal Data Hunter > Welcome! You have access to one of the largest structured legal databases available — 49,658,922 documents spanning 237 countries and 2304 official government sources. This includes 36,860,336 court decisions, 9,623,984 statutes and regulations, and 3,174,602 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 49,658,922 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). Developer plans: Free (20 requests/day), Developer Pro (100,000 requests/month), and Developer Scale (1,000,000 requests/month). See https://legaldatahunter.com/pricing/developers 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: 20,393,415 documents - FR: 3,966,197 documents - LT: 1,912,656 documents - CH: 1,651,528 documents - BR: 1,617,226 documents - AT: 1,582,928 documents - IN: 1,557,821 documents - INTL: 1,088,834 documents - ES: 917,033 documents - DE: 824,638 documents - UK: 749,412 documents - EE: 710,792 documents - RU: 652,939 documents - MX: 608,863 documents - GR: 596,040 documents - IT: 516,551 documents - NL: 490,871 documents - ME: 432,406 documents - HR: 404,994 documents - PT: 376,067 documents - KG: 375,174 documents - AU: 365,434 documents - EU: 343,246 documents - AR: 337,777 documents - BE: 330,508 documents - UN: 311,843 documents - BG: 261,669 documents - RO: 255,861 documents - PL: 249,518 documents - TH: 231,982 documents - KR: 224,669 documents - FI: 220,577 documents - VN: 209,217 documents - DK: 199,776 documents - CA: 193,565 documents - LV: 183,833 documents - IE: 175,726 documents - GE: 163,485 documents - AM: 156,465 documents - HU: 152,659 documents - CO: 146,120 documents - UA: 143,755 documents - CZ: 143,281 documents - TR: 140,656 documents - KZ: 138,752 documents - CoE: 138,015 documents - DO: 129,278 documents - SI: 127,722 documents - HK: 127,498 documents - PH: 120,033 documents - LU: 100,971 documents - CR: 89,902 documents - CY: 80,266 documents - SK: 78,535 documents - UY: 74,718 documents - CV: 69,743 documents - RS: 68,115 documents - BA: 67,649 documents - CN: 67,043 documents - GT: 65,296 documents - CL: 62,251 documents - JP: 62,202 documents - DJ: 57,042 documents - NI: 56,046 documents - MC: 54,179 documents - AZ: 53,186 documents - PK: 37,244 documents - MD: 35,061 documents - PE: 34,712 documents - MO: 34,681 documents - NO: 32,806 documents - NZ: 32,527 documents - OM: 31,643 documents - ZA: 30,903 documents - BO: 28,297 documents - TW: 28,034 documents - LY: 23,727 documents - BH: 22,843 documents - SG: 22,584 documents - PY: 22,173 documents - PA: 21,886 documents - SE: 20,236 documents - SN: 19,892 documents - SA: 19,470 documents - CI: 18,656 documents - BD: 18,442 documents - LK: 17,801 documents - IS: 17,626 documents - AO: 15,033 documents - EC: 15,029 documents - SV: 14,633 documents - BJ: 13,930 documents - ID: 13,830 documents - CW: 13,707 documents - PS: 13,171 documents - MU: 12,482 documents - TG: 12,195 documents - MN: 12,020 documents - MP: 11,222 documents - AW: 11,007 documents - PR: 10,805 documents - NR: 10,339 documents - GI: 9,509 documents - MK: 9,234 documents - UZ: 9,132 documents - MG: 7,435 documents - FO: 7,406 documents - FM: 7,263 documents - AD: 7,249 documents - FJ: 7,124 documents - JO: 6,798 documents - SR: 6,743 documents - IL: 6,720 documents - AL: 6,585 documents - BS: 6,538 documents - KE: 6,327 documents - AE: 6,301 documents - QA: 5,847 documents - IM: 5,837 documents - BM: 5,813 documents - DZ: 5,781 documents - BL: 5,573 documents - TZ: 5,364 documents - TO: 5,342 documents - KH: 5,314 documents - PM: 4,372 documents - LI: 4,267 documents - MT: 4,262 documents - GN: 4,143 documents - ZM: 4,048 documents - VI: 3,918 documents - HT: 3,650 documents - CU: 3,600 documents - XK: 3,403 documents - VA: 3,398 documents - BZ: 3,389 documents - NG: 3,314 documents - BB: 3,303 documents - BN: 3,273 documents - MY: 3,258 documents - AG: 3,246 documents - TN: 3,204 documents - TT: 3,119 documents - GU: 3,046 documents - MF: 2,732 documents - ET: 2,628 documents - FK: 2,547 documents - EG: 2,497 documents - HN: 2,462 documents - GY: 2,328 documents - DM: 2,286 documents - SM: 2,259 documents - TC: 2,198 documents - JE: 2,137 documents - CM: 2,026 documents - SX: 2,013 documents - CG: 1,971 documents - GA: 1,910 documents - LC: 1,905 documents - MA: 1,884 documents - GH: 1,878 documents - NA: 1,866 documents - MS: 1,741 documents - BW: 1,585 documents - KY: 1,453 documents - KN: 1,419 documents - BQ: 1,408 documents - SC: 1,315 documents - ML: 1,288 documents - MM: 1,185 documents - CD: 1,174 documents - MZ: 1,164 documents - ZW: 1,081 documents - RW: 1,075 documents - AI: 1,046 documents - MR: 1,042 documents - VU: 983 documents - VG: 976 documents - JM: 967 documents - UG: 966 documents - SL: 949 documents - GD: 910 documents - NE: 901 documents - SO: 889 documents - TL: 881 documents - TJ: 819 documents - LS: 779 documents - LB: 736 documents - SB: 716 documents - IQ: 689 documents - PF: 639 documents - MH: 617 documents - GG: 614 documents - MV: 570 documents - VE: 568 documents - AX: 561 documents - LR: 507 documents - VC: 504 documents - TD: 464 documents - SY: 462 documents - OECD: 453 documents - MW: 439 documents - BF: 435 documents - WS: 422 documents - TM: 413 documents - NP: 401 documents - SZ: 382 documents - YE: 361 documents - CK: 357 documents - SH: 337 documents - LA: 337 documents - BT: 327 documents - KW: 185 documents - NU: 184 documents - NC: 182 documents - PG: 148 documents - GQ: 145 documents - SD: 144 documents - KM: 132 documents - IR: 129 documents - SS: 124 documents - GL: 121 documents - GM: 110 documents - BY: 72 documents - GW: 65 documents - BI: 54 documents - CF: 53 documents - WF: 42 documents - TV: 38 documents - KI: 36 documents - AF: 35 documents - KP: 25 documents - AS: 20 documents - PW: 16 documents - ER: 15 documents - PN: 15 documents - NF: 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