Inistate MCP logo

Inistate MCP

Connect AI clients to Inistate for workspace, module, entry, activity, file, and schema operations.

Install Inistate MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "inistate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "inistate-mcp"
      ],
      "env": {
        "INISTATE_API_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 21 tools correctly (10d ago).

Overview

Inistate MCP MCP server connects MCP clients to the Inistate platform for workspace selection, module discovery, entry management, activity submission, and file handling. It supports runtime, configure, and frontend modes, with narrower modes exposing smaller tool and resource surfaces. Use it when an agent needs to inspect or modify Inistate data, submit activities in bulk, or design modules through the configure tools. The package runs through npx or a global npm installation and requires an Inistate API token.

Use cases

  • Query entries with filters and pagination
  • Submit activities across up to 100 entries
  • Review entry history and comments
  • Design and validate Inistate modules
  • Upload and download entry files

Key features

  • Workspace and module discovery
  • Entry querying and history
  • Single and bulk activity submission
  • Presigned file upload and download
  • Configure-mode module design
  • Runtime, configure, and frontend modes

Tools21

What Inistate MCP lets your agent do. Expand a tool for its parameters.

Verified live~9.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

Not checked yetLast checked Today

We have not completed a health check for this listing yet.

13/96 checks healthy over the last 84d

What it can do

From the 21 tools this server returned when we ran it; 21 declare their own safety hints.

Runs commands · 1Can delete or modify data · 3Writes files · 2Handles credentials · 1Makes network requests · 3Read-only tools · 15
Network at startup3 connections
Files written at startupNone
Install scriptsprepare
npm provenanceNot published
Package age156 days
Maintainers2

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · inistate-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads1.2kPackage downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed21Callable tools this server registers over MCP.

How Inistate MCP works

What Inistate MCP MCP server does

The Inistate MCP MCP server exposes Inistate workspaces, modules, entries, activities, files, and module-design operations through MCP. Agents can select a workspace, inspect available modules, read module schemas, query entries, retrieve individual records, and review audit history and comments.

Activity operations cover creating, editing, deleting, and running custom activities. The bulk activity tool applies one activity to as many as 100 entries in a single call. File handling includes requesting a presigned upload URL, confirming an upload, downloading files through a presigned URL, and using a base64 or multipart fallback when the presigned flow fails.

How it works

The server authenticates against Inistate with a bearer token and uses the configured API base URL. A typical runtime sequence is to list or select a workspace, inspect a module schema, obtain the form definition for an activity, submit the activity, and then query entries or inspect their history.

Modes control which tools, resources, and prompts are visible. Runtime mode focuses on existing module data and activity execution. Configure mode adds module-design capabilities, while frontend mode also exposes the frontend guide resource. The active mode can be selected with an environment variable or changed through switch_mode.

Setup and configuration

Install the published package with npx -y inistate-mcp, or install it globally with npm. The required setting is INISTATE_API_TOKEN. INISTATE_API_BASE defaults to https://api.inistate.com, and INISTATE_MCP_MODE defaults to configure. Set INISTATE_MCP_NO_SETUP=1 to skip the interactive terminal wizard and start directly as an MCP server.

The setup wizard can create configuration for Claude Desktop, Claude Code, Cursor, Windsurf, Codex CLI, VS Code, Cline, and Gemini CLI. Source installation is also supported by cloning the repository, installing dependencies, building the project, and pointing the client to the generated build/index.js file.

Tools and capabilities

The Inistate MCP MCP server includes tools for:

  • Listing workspaces and modules, then selecting the active workspace.
  • Reading basic or extended module schemas and full canvases with stable IDs.
  • Filtering, sorting, and paginating entries.
  • Reading forms, submitting activities, and applying activities to up to 100 entries.
  • Reviewing entry history, comments, and file records.
  • Uploading and downloading files through presigned URLs or the fallback upload path.
  • Generating, validating, creating, and updating module designs in configure mode.
  • Drafting a module schema from SQLite, Notion, or Airtable data with scaffold_module.

scaffold_module is served by the local inistate-core runtime. When used with the hosted Platform backend, it returns a capability message directing the caller toward design_workflow instead.

Limitations and notes

Configure-only tools are not exposed in runtime mode, and the frontend guide is available only in frontend mode. The available backend determines whether every registered capability can execute. Debug logging is off by default; when enabled, it records write-path tool calls and identifiers but not field values. The recommended file path is the presigned upload flow, with upload_file reserved as a fallback.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Inistate MCP

Inistate MCP is an MCP server that connects AI clients to the Inistate platform. It provides tools for selecting workspaces, discovering modules, reading and filtering entries, submitting activities, reviewing history, and handling files. Configure-mode tools also support module design, validation, creation, updates, and data-based scaffolding where the backend supports it.

Install it with `npx -y inistate-mcp` or install it globally with npm. Running the binary directly in a terminal starts an interactive setup wizard that can generate configuration for supported MCP clients. Source installation is also available through Git, npm install, and the project build command.

Set `INISTATE_API_TOKEN` to a bearer token for Inistate API authentication. `INISTATE_API_BASE` is optional and defaults to `https://api.inistate.com`; `INISTATE_MCP_MODE` is optional and defaults to `configure`.

Yes, Cursor is listed as a supported client in the setup wizard. The wizard can create the client configuration, or you can use the printed JSON configuration and provide `INISTATE_API_TOKEN` in the server environment.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInistate MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/inistate-mcp?style=directory)](https://allmcps.com/mcp/inistate-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/inistate-mcp"><img src="https://allmcps.com/api/badge/inistate-mcp?style=directory" alt="Inistate MCP on AllMCPs" /></a>