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

# Tools

> Full reference of tools exposed by the Kontext MCP server, with arguments and required scopes.

Every tool runs against the organization selected at authorization time, with the scopes granted to the client. Scopes are exact verbs such as `feature:create` or `product:view`; if a scope wasn't granted, the call fails with a 403-equivalent error and the client should prompt the user to re-authorize.

Arguments follow the MCP JSON-schema input format. `productId`, `problemId`, etc. are Kontext resource IDs — they match the values returned by the corresponding `list_*` tool.

## Products

### `list_products`

List all products in the organization.

**Scope:** `product:list` · **Arguments:** *none*

### `get_product`

Get details of a specific product.

**Scope:** `product:view`

| Argument    | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `productId` | string | yes      | Product ID  |

## Features

### `list_features`

List features for a product. Use `format: "tree"` for a nested hierarchy, or `"list"` (default) for a flat list with `parentId` references.

**Scope:** `feature:list`

| Argument    | Type                 | Required | Default  | Description    |
| ----------- | -------------------- | -------- | -------- | -------------- |
| `productId` | string               | yes      |          | Product ID     |
| `format`    | `"list"` \| `"tree"` | no       | `"list"` | Response shape |

### `create_feature`

Create a new feature in a product.

**Scope:** `feature:create`

| Argument      | Type   | Required | Description                                 |
| ------------- | ------ | -------- | ------------------------------------------- |
| `productId`   | string | yes      | Product ID                                  |
| `name`        | string | yes      | Feature name                                |
| `description` | string | no       | Feature description                         |
| `parentId`    | string | no       | Parent feature ID, for hierarchical nesting |
| `releaseId`   | string | no       | Release this feature is associated with     |

## Releases

### `list_releases`

List all releases for a product.

**Scope:** `release:list`

| Argument    | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `productId` | string | yes      | Product ID  |

### `create_release`

Create a new release for a product. Releases track product versions and their associated features.

**Scope:** `release:create`

| Argument      | Type              | Required | Description   |
| ------------- | ----------------- | -------- | ------------- |
| `productId`   | string            | yes      | Product ID    |
| `name`        | string            | yes      | Release name  |
| `notes`       | string            | no       | Release notes |
| `releaseDate` | ISO-8601 datetime | no       | Release date  |

## Feedback

### `list_feedback`

List feedback items for a product, newest first. Cursor-paginated.

**Scope:** `feedback:list`

| Argument    | Type   | Required | Default | Description                              |
| ----------- | ------ | -------- | ------- | ---------------------------------------- |
| `productId` | string | yes      |         | Product ID                               |
| `cursor`    | string | no       |         | Opaque cursor from the previous response |
| `limit`     | number | no       | `50`    | Max items per page (1–100)               |

### `submit_feedback`

Submit user feedback for AI-powered analysis. Returns a feedback ID you can poll for status.

**Scope:** `feedback:create`

| Argument       | Type                                                                                                                                       | Required | Default              | Description                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------- | -------------------- | ------------------------------------------------------- |
| `productId`    | string                                                                                                                                     | yes      |                      | Product ID                                              |
| `body`         | string                                                                                                                                     | yes      |                      | Feedback content (markdown or plain text)               |
| `title`        | string                                                                                                                                     | no       |                      | Title; auto-generated from `body` if omitted            |
| `feedbackType` | `"bug"` \| `"feature_request"` \| `"support_ticket"` \| `"prospect_call"` \| `"support_call"` \| `"research_call"` \| `"generic_feedback"` | no       | `"generic_feedback"` | Kind of feedback                                        |
| `sourceUrl`    | URL                                                                                                                                        | no       |                      | Where the feedback originated (ticket link, call link…) |

## Problems

### `list_problems`

List problems detected from user feedback for a product.

**Scope:** `problem:list`

| Argument    | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `productId` | string | yes      | Product ID  |

### `get_problem`

Get details of a specific problem.

**Scope:** `problem:view`

| Argument    | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `problemId` | string | yes      | Problem ID  |

## Actors

### `list_actors`

List all actors (user personas / segments) for a product.

**Scope:** `actor:list`

| Argument    | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `productId` | string | yes      | Product ID  |

### `create_actor`

Create a new actor for a product. Actors represent the types of users who interact with the product.

**Scope:** `actor:create`

| Argument      | Type   | Required | Description       |
| ------------- | ------ | -------- | ----------------- |
| `productId`   | string | yes      | Product ID        |
| `name`        | string | yes      | Actor name        |
| `description` | string | no       | Actor description |

## Contexts

### `list_contexts`

List all contexts (usage situations / environments) for a product.

**Scope:** `context:list`

| Argument    | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `productId` | string | yes      | Product ID  |

### `create_context`

Create a new context for a product. Contexts describe the situations in which users interact with the product.

**Scope:** `context:create`

| Argument      | Type   | Required | Description         |
| ------------- | ------ | -------- | ------------------- |
| `productId`   | string | yes      | Product ID          |
| `name`        | string | yes      | Context name        |
| `description` | string | no       | Context description |

## Insights

### `get_insights_chart`

Render an interactive chart of product insights trends. Returns the underlying series data **and** an inline-renderable chart via the [MCP Apps](https://modelcontextprotocol.io) extension — see [UI resources](/docs/mcp/ui-resources) for how clients display it.

**Scope:** `insight:view`

| Argument      | Type                                                    | Required | Default     | Description                |
| ------------- | ------------------------------------------------------- | -------- | ----------- | -------------------------- |
| `productId`   | string                                                  | yes      |             | Product ID                 |
| `chartType`   | `"detected-problems-trend"`                             | yes      |             | Chart variant              |
| `granularity` | `"daily"` \| `"weekly"` \| `"monthly"` \| `"quarterly"` | no       | `"monthly"` | Time bucket for the series |
| `dateFrom`    | `YYYY-MM-DD`                                            | no       |             | Lower bound (inclusive)    |
| `dateTo`      | `YYYY-MM-DD`                                            | no       |             | Upper bound (inclusive)    |