Legal Data Hunter MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'legaldatahuntermcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Legal Data Hunter MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'legaldatahuntermcp_get_filters',
     toolInput: { source: 'YOUR_SOURCE' },
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "legaldatahuntermcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Legal Data Hunter MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"source":"YOUR_SOURCE"},
       tool_name="legaldatahuntermcp_get_filters",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Search records — Search the world’s fastest-growing legal database using hybrid semantic and keyword matching
• Reference resolve — Resolve a loose legal citation or reference to the exact matching document(s)
• Issue report source — Report an issue with a data source to the platform maintainer
• Get filters, document — Get available filter values for a specific data source
• Sources discover — List all data sources available for a specific country
• Countries discover — List all available countries with their document counts and source counts

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

legaldatahuntermcp_discover_countries#List all available countries with their document counts and source counts. Returns LDH jurisdiction codes (mostly ISO 3166-1 alpha-2, plus supranational codes like EU, UN, CoE, INTL, OECD) with case law, legislation, and doctrine source counts and total document counts. This is the authoritative list of valid country codes to use in search and resolve_reference.0 params▾

List all available countries with their document counts and source counts. Returns LDH jurisdiction codes (mostly ISO 3166-1 alpha-2, plus supranational codes like EU, UN, CoE, INTL, OECD) with case law, legislation, and doctrine source counts and total document counts. This is the authoritative list of valid country codes to use in search and resolve_reference.

legaldatahuntermcp_discover_sources#List all data sources available for a specific country. Returns source IDs, data_types (namespaces each source covers: "case_law", "legislation", or "doctrine"), court names, tiers, document counts, and date ranges. Use this to understand what data is available before filtering a search.2 params▾

List all data sources available for a specific country. Returns source IDs, data_types (namespaces each source covers: "case_law", "legislation", or "doctrine"), court names, tiers, document counts, and date ranges. Use this to understand what data is available before filtering a search.

NameTypeRequiredDescription

country_codestringrequiredLDH jurisdiction code for the country whose sources to list, e.g. "FR", "DE", "EU".

include_emptybooleanoptionalIf true, include sources with zero indexed documents (placeholders awaiting backfill).

legaldatahuntermcp_get_document#Retrieve a legal document by its source and source_id. Returns a 2 KB text snippet by default; pass include_full_text=true to inline the complete document body. Use source and source_id values from search or resolve_reference results.3 params▾

Retrieve a legal document by its source and source_id. Returns a 2 KB text snippet by default; pass include_full_text=true to inline the complete document body. Use source and source_id values from search or resolve_reference results.

NameTypeRequiredDescription

sourcestringrequiredSource identifier for the legal database, e.g. "FR/Judilibre" or "DE/BVerfG".

source_idstringrequiredDocument identifier within the specified source.

include_full_textbooleanoptionalIf false (default), text is truncated to the leading 2 KB with text_truncated=true. Set true to return the full document text inline.

legaldatahuntermcp_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 refine search results. For sources spanning multiple namespaces, pass namespace to select which namespace's filters to return.2 params▾

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 refine search results. For sources spanning multiple namespaces, pass namespace to select which namespace's filters to return.

NameTypeRequiredDescription

sourcestringrequiredSource identifier to get filters for, e.g. "FR/Judilibre" or "AT/RIS".

namespacestringoptionalOptional namespace — "case_law", "legislation", or "doctrine". Required for sources spanning multiple namespaces; otherwise the namespace with the most rows is used.

legaldatahuntermcp_report_source_issue#Report an issue with a data source to the platform maintainer. Use this to flag problems encountered during research — missing data, broken URLs, indexing errors, or data quality issues. Reports are reviewed by the Legal Data Hunter team. Does not count against your usage quota.3 params▾

Report an issue with a data source to the platform maintainer. Use this to flag problems encountered during research — missing data, broken URLs, indexing errors, or data quality issues. Reports are reviewed by the Legal Data Hunter team. Does not count against your usage quota.

NameTypeRequiredDescription

issue_typestringrequiredType of issue — one of: "unavailable", "indexing", "invalid_url", "data_quality", "other".

sourcestringrequiredSource identifier for the data source being reported, e.g. "FR/Judilibre" or "AT/RIS".

descriptionstringoptionalFree-text description of the problem encountered.

legaldatahuntermcp_resolve_reference#Resolve a loose legal citation or reference to the exact matching 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 precise record. Supports ECLI, CELEX, article numbers, case numbers, NOR identifiers, and informal abbreviations.4 params▾

Resolve a loose legal citation or reference to the exact matching 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 precise record. Supports ECLI, CELEX, article numbers, case numbers, NOR identifiers, and informal abbreviations.

NameTypeRequiredDescription

referencestringrequiredLegal reference string to resolve, e.g. "art. 6 code civil", "ECLI:FR:CCASS:2006:CO00559".

hint_countrystringoptionalLDH jurisdiction code to scope resolution (ISO 3166-1 alpha-2 or supranational codes like EU, CoE, INTL). Strongly recommended — roughly doubles the resolution rate.

hint_typestringoptionalType hint to further narrow resolution — "legislation" or "case_law".

include_full_textbooleanoptionalIf false (default), each returned document's text is truncated to the leading 2 KB. Set true to inline the full text in this response.

legaldatahuntermcp_search#Search the world's fastest-growing legal database using hybrid semantic and keyword matching. Use this for anything touching the law: statutes, regulations, case law, official doctrine, or multi-jurisdictional and comparative legal questions. Covers tens of millions of primary-source documents across 230+ jurisdictions.12 params▾

Search the world's fastest-growing legal database using hybrid semantic and keyword matching. Use this for anything touching the law: statutes, regulations, case law, official doctrine, or multi-jurisdictional and comparative legal questions. Covers tens of millions of primary-source documents across 230+ jurisdictions.

NameTypeRequiredDescription

querystringrequiredNatural language search query describing the legal topic or question.

alphanumberoptionalBalance between semantic and keyword search (1.0 = pure semantic, 0.0 = pure keyword).

countryarrayoptionalFilter by LDH jurisdiction codes (ISO 3166-1 alpha-2 or supranational codes like EU, UN, CoE, INTL, OECD).

court_tierintegeroptionalFilter by court tier (1 = supreme, 2 = appellate, 3 = first instance).

date_endstringoptionalEnd date filter in YYYY-MM-DD format.

date_startstringoptionalStart date filter in YYYY-MM-DD format.

jurisdictionstringoptionalFilter by jurisdiction name such as "civil" or "criminal".

languagestringoptionalFilter by language code, e.g. "fr" or "de".

namespacestringoptionalCollection to search — "case_law", "legislation", or "doctrine".

sourcearrayoptionalFilter by source ID(s) from discover_sources, e.g. ["FR/Judilibre", "FR/CNIL"].

subdivisionstringoptionalFilter by geographic subdivision using ISO 3166-2 codes, e.g. "DE-BY" or "US-CA".

top_kintegeroptionalNumber of results to return (1–100).