# Legal Data Hunter > Welcome! You have access to one of the largest structured legal databases available — 65,683,607 documents spanning 238 countries and 2308 official government sources. This includes 49,051,883 court decisions, 12,572,102 statutes and regulations, and 4,059,622 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 65,683,607 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 (600,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: 21,821,916 documents - BR: 6,164,005 documents - FR: 4,018,812 documents - INTL: 2,517,764 documents - LT: 2,389,001 documents - CN: 2,252,461 documents - IN: 2,137,509 documents - CH: 1,998,006 documents - NL: 1,624,006 documents - AT: 1,584,124 documents - UK: 1,098,948 documents - DE: 1,075,548 documents - ES: 961,307 documents - IT: 784,590 documents - GR: 736,967 documents - EE: 711,322 documents - RU: 698,994 documents - PL: 680,254 documents - MX: 667,149 documents - PT: 591,138 documents - CL: 559,704 documents - ME: 510,928 documents - CZ: 502,383 documents - EU: 473,357 documents - HR: 410,190 documents - AU: 390,927 documents - AR: 385,237 documents - KG: 375,334 documents - BE: 358,897 documents - GE: 350,040 documents - UN: 312,637 documents - DK: 305,610 documents - RO: 267,192 documents - VN: 262,787 documents - BG: 261,678 documents - FI: 236,973 documents - TH: 232,198 documents - KR: 224,865 documents - TR: 197,234 documents - CA: 193,850 documents - CO: 185,659 documents - LV: 184,975 documents - IE: 180,997 documents - LU: 164,702 documents - AM: 156,465 documents - HU: 152,695 documents - UA: 144,424 documents - CoE: 141,722 documents - KZ: 138,803 documents - DO: 133,188 documents - SI: 130,676 documents - HK: 127,505 documents - PH: 124,714 documents - CR: 94,236 documents - PE: 82,377 documents - CY: 80,779 documents - SK: 78,554 documents - UY: 74,790 documents - CV: 70,948 documents - RS: 68,851 documents - BA: 68,478 documents - GT: 65,298 documents - JP: 63,822 documents - UZ: 63,567 documents - MC: 57,925 documents - DJ: 57,064 documents - NI: 56,758 documents - AZ: 53,186 documents - MD: 49,715 documents - PK: 37,292 documents - ZA: 35,707 documents - NO: 35,192 documents - BO: 35,155 documents - MO: 34,844 documents - AD: 33,658 documents - NZ: 32,850 documents - OM: 31,787 documents - IS: 31,269 documents - BD: 31,033 documents - PA: 29,608 documents - TW: 28,192 documents - SN: 27,269 documents - LY: 25,151 documents - BH: 22,932 documents - SG: 22,811 documents - PY: 22,209 documents - SE: 21,794 documents - SA: 19,474 documents - LK: 19,361 documents - CI: 18,815 documents - EC: 16,239 documents - SV: 15,829 documents - AO: 15,321 documents - PS: 14,544 documents - CW: 14,113 documents - BJ: 13,930 documents - ID: 13,919 documents - MU: 12,483 documents - MN: 12,442 documents - TG: 12,220 documents - NC: 11,866 documents - MP: 11,222 documents - AW: 11,127 documents - MK: 11,081 documents - IL: 11,013 documents - FJ: 10,838 documents - PR: 10,805 documents - NR: 10,562 documents - KH: 10,336 documents - PM: 10,090 documents - GI: 9,617 documents - BS: 9,097 documents - BM: 7,959 documents - SR: 7,500 documents - MG: 7,480 documents - TT: 7,453 documents - FO: 7,425 documents - FM: 7,393 documents - KE: 7,112 documents - IM: 6,959 documents - RW: 6,896 documents - JO: 6,849 documents - AL: 6,685 documents - AE: 6,522 documents - TO: 6,066 documents - QA: 5,931 documents - DZ: 5,882 documents - GU: 5,839 documents - TZ: 5,645 documents - BL: 5,575 documents - LC: 5,409 documents - VA: 5,372 documents - BN: 4,961 documents - JM: 4,580 documents - SM: 4,551 documents - LI: 4,450 documents - MY: 4,329 documents - MT: 4,314 documents - GN: 4,245 documents - ZM: 4,125 documents - VI: 3,969 documents - CD: 3,827 documents - HT: 3,810 documents - VU: 3,809 documents - CU: 3,724 documents - BB: 3,462 documents - XK: 3,452 documents - BZ: 3,440 documents - NG: 3,342 documents - AG: 3,337 documents - KY: 3,239 documents - TN: 3,209 documents - GL: 3,208 documents - TL: 3,026 documents - MF: 2,914 documents - GY: 2,833 documents - ET: 2,699 documents - FK: 2,559 documents - EG: 2,516 documents - HN: 2,501 documents - ML: 2,313 documents - DM: 2,286 documents - TC: 2,200 documents - CG: 2,195 documents - JE: 2,150 documents - MA: 2,063 documents - CM: 2,034 documents - SX: 2,034 documents - NA: 2,033 documents - GH: 2,007 documents - GA: 1,910 documents - MS: 1,790 documents - MZ: 1,617 documents - BW: 1,609 documents - BQ: 1,593 documents - KN: 1,419 documents - SC: 1,360 documents - UG: 1,320 documents - SO: 1,288 documents - MM: 1,189 documents - GD: 1,140 documents - IQ: 1,134 documents - ZW: 1,108 documents - MR: 1,084 documents - NE: 1,076 documents - AI: 1,048 documents - SL: 1,035 documents - VG: 980 documents - TJ: 834 documents - LS: 797 documents - LB: 771 documents - SB: 716 documents - PF: 639 documents - MV: 622 documents - GG: 617 documents - MH: 617 documents - AX: 587 documents - VE: 568 documents - VC: 519 documents - LR: 515 documents - NP: 494 documents - SY: 468 documents - WS: 466 documents - TD: 464 documents - CK: 463 documents - MW: 461 documents - OECD: 453 documents - BF: 435 documents - SZ: 428 documents - TM: 417 documents - YE: 361 documents - SH: 338 documents - LA: 337 documents - BT: 328 documents - KM: 293 documents - PG: 200 documents - KW: 185 documents - NU: 185 documents - SD: 171 documents - ST: 155 documents - GQ: 146 documents - IR: 129 documents - SS: 124 documents - GM: 110 documents - AF: 79 documents - BY: 72 documents - GW: 65 documents - BI: 54 documents - CF: 53 documents - WF: 42 documents - TV: 38 documents - KI: 36 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