> For the complete documentation index, see [llms.txt](https://inistate.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://inistate.gitbook.io/home/mcp-integration/mcp.md).

# Overview

Connect AI assistants like Claude to your Inistate workspace using the Model Context Protocol (MCP).

The Inistate MCP server lets AI assistants — Claude, ChatGPT, and others — read and write your Inistate workspace data through natural conversation. Ask the AI to query entries, submit activities, design new modules, or generate custom UI code, all without leaving your chat.

## Prerequisites

* An active Inistate account
* At least one workspace set up in Inistate

If you don't have an account yet, contact your Inistate administrator or sign up at [app.inistate.com](https://app.inistate.com).

## The Three Modes

The server exposes different capabilities depending on the active mode. The default is **configure**, which includes both entry operations and module design tools.

| Mode                      | What it unlocks                                                        | Switch command          |
| ------------------------- | ---------------------------------------------------------------------- | ----------------------- |
| **configure** *(default)* | Entry CRUD + module design and schema tools                            | `switch_mode configure` |
| **runtime**               | Entry queries, activities, history, and file uploads only              | `switch_mode runtime`   |
| **frontend**              | Everything in configure + REST API reference for custom UI development | `switch_mode frontend`  |

{% hint style="info" %}
You can switch modes at any time by telling your AI assistant: *"Switch to runtime mode"* or *"Switch to configure mode."* The tool surface updates immediately without reconnecting.
{% endhint %}

## What do you want to do?

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td>Getting Started</td><td>Connect your AI assistant to the hosted Inistate MCP endpoint.</td><td><a href="/home/mcp-integration/getting-started.md">Getting Started</a></td></tr><tr><td>Working with Entries</td><td>Query, create, edit, delete entries and view audit history.</td><td><a href="/home/mcp-integration/working-with-entries.md">Working with Entries</a></td></tr><tr><td>File Uploads &#x26; Downloads</td><td>Attach files to entries and retrieve existing files.</td><td><a href="/home/mcp-integration/file-uploads.md">File Uploads &amp; Downloads</a></td></tr><tr><td>Designing Modules</td><td>Use AI to design new workflow modules from scratch.</td><td><a href="/home/mcp-integration/designing-modules.md">Designing Modules</a></td></tr><tr><td>Modifying Modules</td><td>Add fields, states, or activities to existing modules.</td><td><a href="/home/mcp-integration/modifying-modules.md">Modifying Modules</a></td></tr><tr><td>Building Custom UIs</td><td>Generate Vue/React code that calls the Inistate REST API directly.</td><td><a href="/home/mcp-integration/building-custom-uis.md">Building Custom UIs</a></td></tr></tbody></table>