# MCP Tools

> Generated parameters for the six public MCP tools.

Canonical: https://keta1930.github.io/icml2026-mcp/en/docs/reference/mcp-tools



MCP clients receive these schemas directly from the server. The table is generated from the same source.

## Behavior [#behavior]

* Results and failures are compact English text.
* A search without `session_id` is stateless.
* Within a search session, returned papers are recorded and omitted from later results.

## Generated parameters [#generated-parameters]

{/* Generated by docs/scripts/generate_reference.py. */}

### `open_search_session` — Open Search Session [#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_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_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 [#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 [#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_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 [#related]

* Ranking behavior: [Retrieval](https://keta1930.github.io/icml2026-mcp/en/docs/concepts/hybrid-search)
* Session behavior: [Search Sessions](https://keta1930.github.io/icml2026-mcp/en/docs/concepts/sessions)
* Stable failure classes: [Error Codes](https://keta1930.github.io/icml2026-mcp/en/docs/reference/errors)