> ## 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.

# Version 0.11.0

> The tools and parameters the MCP server registers at version 0.11.0.

This page lists every customer-facing tool version 0.11.0 registers and the parameters each one takes. To use it, connect to `/mcp/0.11.0`. See [Versions](https://docs.humanintelligence.com/mcp/versions.md) for what changed between versions and how to pin one.

Which of these tools a session gets also depends on the user and your organization. The access-administration tools need the matching Security & Access Control permissions, and `notify_slack` appears once your organization has connected Slack. A client should read the live `tools/list` response.

## Migrating to 0.11.0

Version 0.11.0 has breaking changes. It checks your organization's [narrative policies](https://docs.humanintelligence.com/mcp/overview.md#identity-and-permissions) inside every data query, against the query that is about to run, instead of in a separate step before it. It's available now at:

```
https://chat.svc.humanintelligence.com/mcp/0.11.0
```

When `/mcp` moves to 0.11.0, a client that hasn't been updated may stop working if it calls `check_narrative_policies`, or if it queries without an `intent` for a user your policies apply to. Test against the versioned URL first.

### What changes

| In 0.10.0 | In 0.11.0 |
| - | - |
| Call `check_narrative_policies` with the user's intent, then pass the token it returns to the data tools. | `check_narrative_policies` is removed. Don't call it. |
| `query_people_dataset` takes a `policy_token`. | `query_people_dataset` takes an `intent` instead: a plain description of what the user is trying to find out and why. It is required when your organization's policies apply to the user, and the policies are checked against both the query and the intent. |
| `get_query_result_rows` takes a `policy_token`. | `get_query_result_rows` takes no token. It pages a result only if the query that produced it passed your policies. |

Still on 0.9.0? Read [Migrating to 0.10.0](https://docs.humanintelligence.com/mcp/reference/0-10-0.md#migrating-to-0-10-0) first: it changes the shape of query results, and 0.11.0 keeps that shape.

If your organization has no narrative policies, or none apply to the user, no check runs and `intent` can be left out. Sending it anyway is harmless.

### What to update

**1. Stop calling check\_narrative\_policies**

Remove the call and any code that stores or passes its token.

**2. Send intent with every query**

Pass `intent` to `query_people_dataset`: a complete, self-contained
statement of what the user is trying to find out and why, written from the
whole conversation, not just the last message.

**3. Remove policy\_token**

Drop `policy_token` from `query_people_dataset` and
`get_query_result_rows` calls.

**4. Handle a policy refusal**

When a query conflicts with a policy, `query_people_dataset` returns a
refusal explaining why instead of data. Show it to the user rather than
retrying.

**5. Test, then switch**

Point a test client at `/mcp/0.11.0` and run your usual queries. Then either
keep the versioned URL or move back to `/mcp` once it serves 0.11.0.

### If you need more time

Pin your client to the version it works with today, `https://chat.svc.humanintelligence.com/mcp/0.10.0` or `/mcp/0.9.0`, before the default moves. Pinned versions keep serving unchanged.

The full tool and parameter list for 0.11.0 follows.

## Identity

### `whoami`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#whoami).

Takes no parameters.

## Discovery

### `list_people_datasets`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#list-people-datasets).

Takes no parameters.

### `search_people_datasets`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#search-people-datasets).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `query` | string | Yes | |
| `kinds` | array of string | No | `dataset`, `metric`, `dimension`, `time_dimension`, `segment` |
| `datasets` | array of string | No | |
| `limit` | integer | No | |

## Schema and methodology

### `describe_people_dataset`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#describe-people-dataset).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `datasets` | array of string | Yes | |

### `explain_people_dataset`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#explain-people-dataset).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `datasets` | array of string | Yes | |
| `metric_names` | array of string | No | |

## Querying

### `query_people_dataset`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#query-people-dataset).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `version` | string | Yes | |
| `metrics` | array of object | Yes | |
| `dimensions` | array of any | No | |
| `time_dimensions` | array of object | No | |
| `segments` | array of any | No | |
| `where` | object | No | |
| `having` | object | No | |
| `segment_check` | object | No | |
| `order` | array of object | No | |
| `query_limit` | integer | No | |
| `query_offset` | integer | No | |
| `timezone` | string | No | |
| `meta` | object | Yes | |
| `extensions` | object | No | |
| `intent` | string | No | |

### `get_query_result_rows`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#get-query-result-rows).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `data_handle` | string | Yes | |
| `result_offset` | integer | No | |
| `result_limit` | integer | No | |

## Access administration

### `get_access_config`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#get-access-config).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `view` | string | Yes | `overview`, `categories`, `boundaries`, `rules`, `roles`, `role_categories`, `hierarchies`, `change_plans` |

### `search_access_boundary_org_units`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#search-access-boundary-org-units).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `hierarchyTypeId` | string | Yes | |
| `q` | string | No | |
| `subtype` | string | No | |
| `limit` | integer | No | |

### `get_dataset_access_governance`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#get-dataset-access-governance).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `datasetName` | string | Yes | |

### `check_role_access`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#check-role-access).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `roleSlugs` | array of string | Yes | |
| `email` | string | No | |

### `preview_access_change`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#preview-access-change).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `operations` | array of object | Yes | |

### `apply_access_change`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#apply-access-change).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `plan_token` | string | Yes | |

### `set_session_context`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#set-session-context).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `orgId` | string | No | |
| `roleSlugs` | array of string | No | |
| `email` | string | No | |
| `planToken` | string | No | |
| `reviewOnly` | boolean | No | |
| `minutes` | integer | No | |

### `clear_session_context`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#clear-session-context).

Takes no parameters.

## Documentation

### `search_docs`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#search-docs).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `query` | string | Yes | |
| `limit` | integer | No | |

## App building

### `get_artifact_sdk`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#get-artifact-sdk).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `package` | string | Yes | `app`, `design-system`, `brand` |
| `file` | string | No | |
| `offset` | integer | No | |

## Notifications

### `notify_slack`

What it does: [tool reference](https://docs.humanintelligence.com/mcp/tools.md#notify-slack).

| Parameter | Type | Required | Allowed values |
| - | - | - | - |
| `email` | string | Yes | |
| `text` | string | Yes | |


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