MCP Tools
Generated parameters for the six public MCP tools.
MCP clients receive these schemas directly from the server. The table is generated from the same source.
Behavior
- Results and failures are compact English text.
- A search without
session_idis stateless. - Within a search session, returned papers are recorded and omitted from later results.
Generated parameters
open_search_session — Open Search Session
Start a search session and return its ID. Pass that ID to later search calls to leave out papers already returned in the session.
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
label | string | no | "" | max chars 120 | Optional topic label for the session. |
default_top_k | integer | null | no | unset | ≥ 1, ≤ 50 | Default number of results returned per round for this session. |
Returns MCP text content; failures use stable error[code] text.
search_papers — Search Papers
Search 6,341 ICML 2026 papers. With session_id, leave out papers already returned in that session.
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
query | string | yes | — | min chars 1, max chars 2000 | Natural-language research topic or method. |
session_id | string | null | no | unset | — | Search session ID used to leave out previously returned papers. |
top_k | integer | null | no | unset | ≥ 1, ≤ 50 | Maximum number of new papers to return. |
search_depth | integer | null | no | unset | ≥ 1 | Number of ranked candidates to check before session deduplication. |
area | string | null | no | unset | — | Research area filter. |
paper_type | string | null | no | unset | — | Paper type filter. |
spotlight_only | boolean | no | false | — | Return only spotlight papers. |
min_score | number | null | no | unset | ≥ 0.0, ≤ 1.0 | Minimum normalized hybrid-ranking score. |
include_abstract | boolean | no | true | — | Include abstract previews in the result. |
Returns MCP text content; failures use stable error[code] text.
close_search_session — Close Search Session
Close a search session and return a short summary.
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
session_id | string | yes | — | min chars 1 | Search session ID to close. |
Returns MCP text content; failures use stable error[code] text.
search_session_status — Search Session Status
Show progress for one search session.
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
session_id | string | yes | — | min chars 1 | Search session ID to inspect. |
include_papers | boolean | no | false | — | Include a bounded list of paper titles. |
Returns MCP text content; failures use stable error[code] text.
get_papers — Get Papers
Fetch papers by OpenReview ID. With session_id, record found papers as returned in that session.
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
paper_ids | string[] | yes | — | min items 1, max items 50 | OpenReview paper IDs. |
session_id | string | null | no | unset | — | Search session in which found papers are recorded as returned. |
Returns MCP text content; failures use stable error[code] text.
list_paper_areas — List Paper Areas
List available area and paper_type values with corpus counts.
| Parameter | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| — | — | — | — | — | No parameters |
Returns MCP text content; failures use stable error[code] text.
Related
- Ranking behavior: Retrieval
- Session behavior: Search Sessions
- Stable failure classes: Error Codes