Search datasets
search_datasetsMdexa is a database of biomedical datasets that agents call over MCP or, with an API key, an HTTP API. Use this first: keywords (q) and filters, every condition in one call. COMPLETENESS: 'Complete: these are ALL N datasets ...' means you hold the full answer: do not repeat the search with other words or filters. FILTERS: several values of ONE parameter are ORed; different parameters are ANDed; a parent domain includes its sub-domains. The tag facets task_format, intended_use, specialty, condition_scope, population, source_type, annotation_depth, expert_involvement, size_tier, data_format, official_split, benchmark_status (specialty = department, condition_scope = ICD-11 chapter); their values come from list_facets (only=), and a wrong value is answered with the allowed ones. Known slugs: slugs=a,b needs no keyword. q: Chinese or English or another language; typos, synonyms and meaning are matched. Each row has answer (license status, commercial_use, derivatives, redistribution, key quote with URL and date), risk_flags, repo_only (true = only a code repository license), card_url, last_verified: enough for license questions. Models: code and weights licenses apart. Registered entries: no conclusion. restricted, conflict, unstated and unverifiable never mean commercial use is allowed. Output fits max_tokens (default 1500); next_cursor gives more. no_match (did_you_mean) means the Mdexa database does not list it: do not retry with other words. related rows are nearby records, NOT matches.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_datasets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Keywords or a short description, any language. | |
| lang | No | en | |
| sort | No | relevance | |
| tier | No | verified and practical: license concluded with evidence; registered: listed, NOT verified. Default all, verified first. | |
| type | No | ||
| hints | No | off: no return note and the visit is not recorded (the same as the header X-Mdexa-Hints: off). on or absent: default. | |
| limit | No | ||
| match | No | all = every word must match. | ranked |
| prior | No | false = pure text relevance. | |
| slugs | No | Exact slugs (OR); unknown ones come back in unknown_slugs. | |
| cursor | No | next_cursor of the previous response. | |
| domain | No | ||
| system | No | ||
| explain | No | Add match.fields / match.via to each row. | |
| hosting | No | ||
| year_to | No | ||
| language | No | BCP 47, e.g. zh, lzh, en. | |
| modality | No | ||
| synonyms | No | false = literal words only. | |
| risk_flag | No | none = no flag. | |
| size_tier | No | ||
| specialty | No | ||
| year_from | No | ||
| max_tokens | No | Response size cap in estimated tokens; rows are dropped from the end. | |
| population | No | ||
| tag_source | No | declared = only tags the authors state or a reviewer confirmed. | any |
| data_format | No | ||
| source_type | No | ||
| task_format | No | ||
| content_type | No | ||
| intended_use | No | ||
| license_status | No | permissive = commercial use and redistribution allowed; unreviewed = registered, no conclusion. | |
| official_split | No | ||
| condition_scope | No | ||
| include_derived | No | false = only stated or inferred tags. | |
| annotation_depth | No | ||
| benchmark_status | No | ||
| expert_involvement | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| total | No | ||
| complete | No | ||
| no_match | No | ||
| next_cursor | No |