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

# Changes and compatibility

> What can change as Nimt MCP evolves, and how to keep connections reliable.

Nimt MCP is continuously evolving. We add capabilities and improve how tools
communicate with AI assistants. The current service is in pre-release: tool
names, parameters, response structures, and behavior may change, and there is
no fixed-schema or backward-compatibility guarantee during this period.

## If you use ChatGPT or Claude

Keep your client updated. If it shows an outdated tool list, refresh the Nimt
connection or reconnect using the [client guide](/mcp/setup). Review newly
requested permissions before approving them.

You do not need identical wording to use Nimt successfully. Your assistant
chooses how to summarize the data, so formatting, phrasing, and the order of an
AI-written answer can differ between conversations.

Read the [changelog](/mcp/changelog) for documented changes to the customer MCP.

## If you build a custom integration

* Discover the current tool catalog and input/output schemas with `tools/list`.
  Do not permanently cache a copied tool definition.
* Validate inputs against the current schema. Do not send unknown parameters
  because a client or another Nimt interface accepts them.
* Consume structured results according to the advertised output schema. Avoid
  parsing the assistant's prose or comparing entire serialized responses to an
  example copied from these docs.
* Handle additional output fields without assuming your stored schema is the
  only possible shape. Validate the fields you rely on; do not silently ignore
  missing required fields or changed types.
* Treat IDs as opaque values, paginate explicitly, and compare records by ID
  rather than array position unless an order is documented.
* Handle missing tools, authorization failures, and changed schemas explicitly.
  Refresh discovery and review the changelog instead of blindly retrying.

The server version reported during MCP initialization identifies the deployed
implementation. It is not a version-pinning option for this hosted endpoint.
If your integration requires a fixed contract, contact
[support@nimt.ai](mailto:support@nimt.ai) before depending on it for an unattended
or business-critical workflow.

## Live data and exact equality

Even without a tool change, two calls can return different results:

* Projects, configuration, membership, and stored data can change between calls.
* `fetchedAt` changes with each metadata collection.
* Paginated calls and the fields in a metadata response are not a single
  transactional snapshot of the entire workspace.
* Lists without a documented ordering should not be compared by position.

For comparisons, align the workspace, project, filters, pagination, and collection
period. Compare the relevant values by identifier and account for volatile
fields such as `fetchedAt`.

This is not a reason to dismiss incorrect results. A tool result should match its
advertised schema and accurately describe the data it reads. If comparable
results conflict or a required field is missing, report the discrepancy through
[troubleshooting](/mcp/troubleshooting#get-help).

## How we communicate changes

We favor additive changes and preserving existing behavior where practical.
Changes that require customer action should have a changelog entry explaining
what changed and how to adapt. Security fixes may require prompt changes or
reauthorization.

During pre-release, do not assume a fixed notice period, a pinned tool set, or
that every schema change will happen automatically inside an existing chat.
Refresh the connection after a relevant update and retest workflows you rely on.