> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humanintelligence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versions

> How MCP server versions work, what changed in each one, and when to pin a version.

The [MCP server](https://docs.humanintelligence.com/mcp/overview.md)'s tools and their inputs and outputs are versioned. Each version is fixed once published: a client connected to a version keeps the same tools and the same schemas for as long as that version is served.

## Choosing an endpoint

| Endpoint | What you get |
| - | - |
| `https://chat.svc.humanintelligence.com/mcp` | The current default version. It moves forward when a new version becomes the default. |
| `https://chat.svc.humanintelligence.com/mcp/<version>` | That version, unchanged, for as long as it is served. |

The current default is **0.9.0**. The latest version is **0.11.0**.

Use `/mcp` for interactive assistants such as Claude, which read the tool list each time they connect and adapt to changes. **Pin a version** for anything built against specific tool calls: an internal app, a scheduled job, or an agent harness whose prompts are tuned to a tool contract. A pinned version only changes when you change the URL.

> [!TIP]
>
> Pin in production and test the latest version in development. That way you
> find out about a contract change on your own schedule.

## How versions change

* **Additive changes**, such as a new tool or a new optional parameter, can ship in a new version without notice. Existing calls keep working.
* **Breaking changes**, such as a removed or renamed tool, a newly required parameter, or a changed result shape, ship first as a new version you can test at its versioned URL. The default only moves to a version with breaking changes on a date we announce in advance. The version history below marks each breaking version, with a migration guide where you need to change your client.
* **If you're not ready to move**, pin the version you're on before the announced date. Older versions stay served.

Some clients, including ChatGPT, keep the tool list they read when they first connected. After the default moves, refresh or reconnect the connector so it reads the new list.

## Version history

| Version | What changed | Breaking |
| - | - | - |
| 0.11.0 | Your organization's data policies are checked inside every data query. `check_narrative_policies` is removed, and `query_people_dataset` takes an `intent` that is required when your policies apply to the user. See [Migrating to 0.11.0](https://docs.humanintelligence.com/mcp/reference/0-11-0.md#migrating-to-0-11-0). | Yes |
| 0.10.0 | `query_people_dataset` returns formatted text values as a pair of the stored value and its display form, so a value copied from a breakdown works as a filter. See [Migrating to 0.10.0](https://docs.humanintelligence.com/mcp/reference/0-10-0.md#migrating-to-0-10-0). | Yes, result shape |
| 0.9.0 | Adds the [access-administration tools](https://docs.humanintelligence.com/mcp/tools.md#access-administration). **Current default.** | No |
| 0.8.0 | Adds [`search_docs`](https://docs.humanintelligence.com/mcp/tools#search-docs). | No |
| 0.7.0 | No change to the tools on this page. | No |
| 0.6.0 | No change to the tools on this page. | No |
| 0.5.0 | Query paging is renamed: `limit` and `offset` become `query_limit` and `query_offset`; `get_dataset_rows` becomes `get_query_result_rows`, taking `result_limit` and `result_offset`; the result's `truncated` flag splits into `preview_truncated` and `result_truncated`. | Yes |
| 0.4.0 | Adds `check_narrative_policies`. | No |
| 0.3.0 | Adds [`notify_slack`](https://docs.humanintelligence.com/mcp/tools#notify-slack), which appears once your organization has connected Slack. | No |
| 0.2.0 | Adds [`explain_people_dataset`](https://docs.humanintelligence.com/mcp/tools#explain-people-dataset). `query_people_dataset` requires the query's purpose and the user's question. | Yes |
| 0.1.1 | First published version. | — |

Full tool and parameter references: [Version 0.9.0](https://docs.humanintelligence.com/mcp/reference/0-9-0.md), [Version 0.10.0](https://docs.humanintelligence.com/mcp/reference/0-10-0.md), [Version 0.11.0](https://docs.humanintelligence.com/mcp/reference/0-11-0.md).

## Tools by version

Which customer-facing tools each version registers. A session may see fewer: some tools also depend on the user's permissions and your organization's setup, as the [tool reference](https://docs.humanintelligence.com/mcp/tools.md#tool-availability) explains.

| Tool | 0.11.0 | 0.10.0 | 0.9.0 | 0.8.0 | 0.7.0 | 0.6.0 | 0.5.0 | 0.4.0 | 0.3.0 | 0.2.0 | 0.1.1 |
| - | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: | :-: |
| `whoami` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| `check_narrative_policies` | | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | | |
| `list_people_datasets` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| `search_people_datasets` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| `describe_people_dataset` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| `explain_people_dataset` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |
| `query_people_dataset` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| `get_dataset_rows` | | | | | | | | Yes | Yes | Yes | Yes |
| `get_query_result_rows` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | | | |
| `get_access_config` | Yes | Yes | Yes | | | | | | | | |
| `search_access_boundary_org_units` | Yes | Yes | Yes | | | | | | | | |
| `get_dataset_access_governance` | Yes | Yes | Yes | | | | | | | | |
| `check_role_access` | Yes | Yes | Yes | | | | | | | | |
| `preview_access_change` | Yes | Yes | Yes | | | | | | | | |
| `apply_access_change` | Yes | Yes | Yes | | | | | | | | |
| `set_session_context` | Yes | Yes | Yes | | | | | | | | |
| `clear_session_context` | Yes | Yes | Yes | | | | | | | | |
| `search_docs` | Yes | Yes | Yes | Yes | | | | | | | |
| `get_artifact_sdk` | Yes | Yes | Yes | | | | | | | | |
| `notify_slack` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.