Inistate
Inistate is a process platform where AI agents and humans share the same workflow primitives — same forms, same state transitions, same audit trail. Connect any MCP client (Claude, Cursor, Gemini CLI, custom agents) to design modules, run state transitions, query entries, and upload files against live Inistate workspaces. Agents work inside a governed state machine with confidence-gated escalation and full reasoning capture (model, sources, prompt hash). Built on FACTSOps and the patented ProcessCanvas notation. No system prompt required — the schema is the prompt.
Overview
Inistate MCP Server
MCP server for the Inistate platform — module discovery, entry management, and activity submission.
Setup
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
INISTATE_API_TOKEN | Yes | — | Bearer token for Inistate API authentication |
INISTATE_API_BASE | No | https://api.inistate.com | API base URL |
Install from npm (recommended)
No clone or build needed — npx will fetch and run the published package on demand:
npx -y inistate-mcp
Or install globally:
npm install -g inistate-mcp
inistate-mcp
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"inistate": {
"command": "npx",
"args": ["-y", "inistate-mcp"],
"env": {
"INISTATE_API_TOKEN": "your-token-here"
}
}
}
}
Claude Code Configuration
claude mcp add inistate -e INISTATE_API_TOKEN=your-token-here -- npx -y inistate-mcp
Install from source
git clone https://github.com/Inistate/inistate-mcp.git
cd inistate-mcp
npm install
npm run build
Then point your MCP client at node /absolute/path/to/inistate-mcp/build/index.js.
Tools
| Tool | Description |
|---|---|
list_workspaces | List workspaces the user has access to |
set_workspace | Set the active workspace |
list_modules | List all discoverable modules in the workspace |
get_module_schema | Get the canvas schema (basic or extended tier) |
get_module_canvas | Get full module definition with stable IDs (round-trippable) |
list_entries | Query entries with filters, sorting, and pagination |
get_entry | Read a single entry by ID |
get_form | Get form fields and defaults for an activity |
submit_activity | Create, edit, delete, or run custom activities |
get_entry_history | Get entry audit trail and comments |
upload_file | Upload a file to S3 storage |
download_file | Download a file (returns pre-signed URL) |
design_workflow | Generate a scaffolded module template from a description |
validate_design | Validate a module schema before creating or updating |
create_module | Create a new module with schema |
update_module | Update an existing module's schema |
Resources
| URI | Description |
|---|---|
inistate://modules | List all modules |
inistate://modules/{name}/canvas | Basic module schema (fields + states) |
inistate://modules/{name}/canvas/extended | Extended schema with activities and flows |
inistate://schema | FACTSOps schema definition (field types, colors, validation rules) |
inistate://design-guide | FACTS Module Design Guide |
Prompts
| Prompt | Description |
|---|---|
design_factsops_workflow | Guide an agent through designing a complete workflow module |
execute_activity | Guide an agent through executing a specific activity |
diagnose_entry | Guide an agent through investigating an entry's state and history |
Typical Workflow
list_workspaces→set_workspace— select a workspacelist_modules— find the module you needget_module_schema— understand its fields, states, and activitiesget_form— discover required fields before submittingsubmit_activity— create or update entrieslist_entries— query and browse dataget_entry_history— review entry history
Development
npm run watch # Watch mode for TypeScript compilation
npm run inspector # Test with MCP Inspector
PM2 (Ubuntu/AWS)
Run the HTTP transport in production using PM2:
npm install
npm run build
npm run pm2:start
npx pm2 save
Enable startup on reboot:
sudo npx pm2 startup systemd -u ubuntu --hp /home/ubuntu
npx pm2 save
Common operations:
npm run pm2:restart
npm run pm2:logs
npm run pm2:stop
Set required environment variables (INISTATE_API_TOKEN, and optionally INISTATE_API_URL, INISTATE_WORKSPACE_ID, OAUTH_ISSUER_URL, INISTATE_APP_URL) in your shell, PM2 ecosystem env, or deployment secret manager before starting.
Testing
Run all tests
npm test
Watch mode (re-runs on file changes)
npm run test:watch
Test structure
Tests are in src/ alongside the source files and use Vitest:
| File | Type | What it covers |
|---|---|---|
src/schema.test.ts | Unit tests (50) | designWorkflow, validateDesign, helper functions (isValidFieldType, isValidColor, isValidActor, suggestColorForState) |
src/server.test.ts | Integration tests (14) | Spins up the MCP server as a child process and exercises it through the official MCP SDK client — tool discovery, resource reads, prompt retrieval, and local tool calls |
Unit tests cover:
- Field type and color validation against the schema
- State color suggestion logic
- Design validation: duplicate names, invalid types/colors/actors, initial state rules, flow integrity, unreachable states, unused activities, AI confidence warnings
- Workflow design: pattern detection (approval, ticket, pipeline, record list), industry defaults
- Intent resolution: all 5 modes, context boosting, confidence scoring
Integration tests verify (no API token needed):
- All 17 tools, 5 resources, and 3 prompts are registered
design_workflow,validate_designwork end-to-end through the MCP protocol- Static resources (
inistate://schema,inistate://design-guide) return valid content - All 3 prompts return correctly templated messages
Interactive testing with MCP Inspector
INISTATE_API_TOKEN=your-token npm run inspector
Opens a browser UI where you can interactively call tools, inspect schemas, and see responses.
Server Config
{
"mcpServers": {
"Inistate": {
"type": "streamable-http",
"url": "https://mcp.inistate.com/mcp",
"note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
}
}
}Project Info
Created At
a month agoUpdated At
25 days agoAuthor Name
InistateStar
-Language
-License
-Recommend Servers
View AllSigstore
@3089464667
21 hours ago
Littleorange Video Mcp
@littleorange-ai
21 hours ago