WIV MCP Server

Modified on Fri, 20 Feb at 8:56 PM

WIV MCP Server

Connection & Setup Guide

Version 4.2 | February 2026

Overview

The WIV MCP Server allows AI-powered IDEs and assistants (Cursor, VS Code, Claude, ChatGPT) to interact with your WIV workflow management platform. It uses the Model Context Protocol (MCP) standard to expose WIV tools like listing workflows, managing cases, running executions, and more.

Authentication is handled via PropelAuth OAuth 2.1. After signing in, an API key is generated for your organization and used for all subsequent requests.

How the Connection Flow Works

The https://mcp.wiv.ai page provides a simple sign-in flow that generates a pre-configured connection for your IDE or AI assistant.

1	Visit /connect	Open the MCP server URL in your browser and click "Sign in with WIV".
2	Authenticate	You are redirected to PropelAuth (WIV's identity provider) to log in with your WIV credentials.
3	Select Org	If you belong to multiple organizations, choose which one to connect. Single-org users skip this step.
4	API Key Created	The server creates a PropelAuth API key scoped to your organization. This key authenticates all MCP requests.
5	Install	Click "Open in Cursor", "Open in VS Code", or copy the configuration for manual setup.

Architecture

The system has three main components:

WIV MCP Server — hosted on AWS App Runner, serves SSE (Server-Sent Events) endpoint for MCP communication
PropelAuth — handles OAuth 2.1 authentication, user management, and API key lifecycle
WIV API — the backend API that the MCP server proxies requests to, using the generated API key

When an IDE connects to the MCP server's /sse endpoint with an X-API-Key header, the server forwards requests to the WIV API with the same key. PropelAuth validates the key and resolves the organization context.

Setup Instructions

Cursor

Option A: One-click install

Visit the https://mcp.wiv.ai page and sign in.
Click "Open in Cursor" — this opens a deeplink that auto-configures the MCP server.
Cursor will prompt you to confirm the installation.

Option B: Manual setup

Add the following to your .cursor/mcp.json file:

{

"mcpServers": {

"wiv": {

"url": "https://mcp.wiv.ai/sse",

"headers": { "X-API-Key": "<your-api-key>" }

}

VS Code

Option A: One-click install

Visit the /connect page and sign in.
Click "Open in VS Code" — uses the vscode:mcp/install deeplink.
VS Code will prompt you to confirm.

Option B: Manual setup

Open VS Code Settings (JSON) and add the MCP server configuration, or add it to .vscode/mcp.json in your workspace.

Claude Desktop / Claude.ai

Claude.ai (Pro/Max/Team/Enterprise):

Go to Settings → Connectors → Add custom connector.
Paste the MCP server URL (e.g., https://mcp.wiv.ai/sse).
Complete the OAuth sign-in when prompted.
Enable the WIV connector in your chat via the "+" button → Connectors.

Claude Desktop:

Add to your claude_desktop_config.json:

{

"mcpServers": {

"wiv": {

"command": "npx",

"args": [

"mcp-remote",

"https://mcp.wiv.ai/sse",

"--header",

"X-API-Key: <your-api-key>"

]

}

Restart Claude Desktop after saving.

ChatGPT

Requirements: ChatGPT Pro, Plus, Team, or Enterprise with Developer Mode enabled.

Go to Settings → Connectors → Advanced settings and enable Developer Mode.
Click Add new connector (or Settings → Apps & Connectors → Add).
Enter name: WIV and paste the server URL.
Click Create and complete the OAuth sign-in.
In a new chat, enable the WIV connector via "Add sources" or the connectors menu.

Note: ChatGPT uses OAuth for authentication. API key headers are not supported for ChatGPT connectors — use the OAuth flow instead.

Available MCP Tools

Once connected, the following tools are available to your AI assistant:

Tool	Description
wiv_list_workflows	List all workflows
wiv_get_workflow	Get details of a specific workflow
wiv_update_workflow	Update an existing workflow
wiv_list_spaces	List all available spaces
wiv_get_space	Get details of a specific space
wiv_get_space_resources	Get resources in a space
wiv_list_folders	List workflow folders
wiv_get_folder	Get a specific workflow folder
wiv_start_execution	Start/run a workflow execution
wiv_list_all_executions	List executions for all workflows
wiv_list_workflow_executions	List executions for a specific workflow
wiv_stop_execution	Stop a workflow execution
wiv_get_execution_status	Get the status of a workflow execution
wiv_list_cases	List cases with optional filters
wiv_search_cases	Search cases with filters, date range, and pagination
wiv_get_cases_summary	Get cases summary/statistics
wiv_get_cases_filters	Get available case filters
wiv_get_cases_filter_values	Get possible values for a case filter
wiv_cases_query	Flexible cases query using OpenSearch
wiv_search_msp_cases	Search cases across MSP child tenants
wiv_get_msp_cases_summary	Get MSP cases summary across child tenants
wiv_get_msp_cases_filter_values	Get possible values for MSP case filter
wiv_list_msp_cases_types	List case types across MSP child tenants
wiv_msp_cases_query	Flexible MSP cases query using OpenSearch
wiv_generate_workflow	Generate a workflow using AI from natural language
wiv_get_generated_workflow	Poll for AI-generated workflow result

Security Notes

API keys are scoped to a single organization and cannot access other tenants.
Keys are created via PropelAuth's Backend API and follow the same lifecycle as manually-created keys.
The MCP server does not store tokens or keys — they are passed through to the WIV API on each request.
HTTPS is enforced for all connections (AWS App Runner with TLS).
OAuth 2.1 with PKCE is used for the authentication flow.

Troubleshooting

Connection refused or timeout

Ensure the MCP server URL is correct and includes /sse at the end. Check that your network allows outbound HTTPS connections.

401 Unauthorized

Your API key may have expired or been revoked. Visit /connect to generate a new one.

Tools not showing up

In Claude.ai, enable the connector in your chat. In Cursor/VS Code, restart the IDE after adding the configuration. In ChatGPT, ensure Developer Mode is enabled.

Wrong organization data

If you see data from the wrong organization, visit https://mcp.wiv.ai again and select the correct organization during the setup flow.