Signavio MCP Server

A comprehensive Model Context Protocol (MCP) server that provides seamless integration between SAP Signavio Process Manager and AI-powered development tools. This server exposes the complete Signavio API as a set of tools, enabling AI assistants like Claude, Cursor, and other MCP-compatible clients to interact with your Signavio workspace programmatically.

Overview

The Signavio MCP Server bridges the gap between business process management and AI-assisted development workflows. Whether you're automating process documentation, managing business process models, maintaining process dictionaries, or integrating Signavio data into your development pipeline, this server provides a unified interface for all Signavio API operations.

Key Features

• Complete API Coverage: Full access to Signavio Process Manager API endpoints including models, folders, dictionary entries, and search functionality

• AI Assistant Integration: Seamlessly works with Claude, Cursor, and other MCP-compatible AI development tools

• Business Process Automation: Automate process model creation, updates, exports, and management tasks

• Dictionary Management: Create, update, and search business process dictionaries and glossary entries

• Multi-format Export: Export process models in JSON, BPMN 2.0 XML, PNG, and SVG formats

• Search Capabilities: Full-text search across models, revisions, files, and dictionary entries

• Zero Configuration: Run directly with npx or install locally for development

Prerequisites

• Node.js (v14 or higher)

• npm or yarn

• Signavio account with API access

• Your Signavio tenant ID (Workspace ID)

Installation

Option 1: Using npx (Recommended)

No installation required! You can run the MCP server directly using npx:

Option 2: Local Installation

1. Install the package:

   npm install signavio-mcp

2. Or clone the repository:

   git clone https://github.com/willpowell8/signavio-mcp.git cd signavio-mcp npm install

Configuration

Configure environment variables:

Create a .env file in the project root with your credentials:

Note: The base URL is region-specific. Use the appropriate URL for your region:

• EU: https://api.eu.signavio.cloud.sap

• USA: https://api.us.signavio.cloud.sap

• Australia: https://api.au.signavio.cloud.sap

• Canada: https://api.ca.signavio.cloud.sap

• Japan: https://api.jp.signavio.cloud.sap

• Singapore: https://api.sgp.signavio.cloud.sap

• South Korea: https://api.kr.signavio.cloud.sap

Finding Your Tenant ID

To find your tenant ID (Workspace ID):

1. Log in to SAP Signavio Process Manager

2. In the Explorer, go to Help menu

3. Select Workspace information

4. Copy the Workspace ID - this is your tenant ID

Security Notes

• Never commit your .env file to version control

• The .env file should be included in .gitignore

• Consider using environment variables or a secrets manager for production use

MCP Server Configuration

The MCP server uses environment variables from your .env file. You can also:

• Set environment variables in your system

• Pass environment variables when starting the server

MCP Client Configuration

For Cursor or other MCP-compatible clients, add this to your MCP configuration:

Using npx (Recommended):

Using locally installed package:

Available MCP Tools

The MCP server provides the following tools:

Authentication

• signavio_authenticate - Authenticate with Signavio API

Directory/Folder Operations

• signavio_get_root_folders - Get workspace root folders

• signavio_get_folder_contents - Get folder contents by ID

• signavio_create_folder - Create a new folder

• signavio_update_folder - Rename or update folder description

• signavio_move_folder - Move folder to new parent or trash

• signavio_delete_folder - Permanently delete a folder

Dictionary/Glossary Operations

• signavio_search_dictionary - Search dictionary entries

• signavio_get_dictionary_entry - Get specific dictionary entry

• signavio_create_dictionary_entry - Create new dictionary entry

• signavio_update_dictionary_entry - Update dictionary entry

• signavio_delete_dictionary_entry - Delete dictionary entry

• signavio_get_dictionary_categories - Get all dictionary categories

• signavio_get_dictionary_category - Get specific category

• signavio_create_dictionary_category - Create new category

Model Operations

• signavio_get_model - Get model metadata

• signavio_get_model_revisions - Get all model revisions

• signavio_export_model - Export model (json, bpmn2_0_xml, png, svg)

• signavio_create_model - Create new model/diagram

• signavio_update_model - Update model (creates new revision)

• signavio_move_model - Move model to different folder

• signavio_publish_model - Publish model(s) to Collaboration Hub

Search Operations

• signavio_search - Full-text search across all content types

Running the MCP Server

Using npx (Recommended):

Using locally installed package:

Or directly:

Testing the MCP Server

A comprehensive test script is available to verify all MCP server functionality:

Or directly:

The test script will:

• ✅ Test authentication

• ✅ Test directory/folder operations (get root folders, get folder contents)

• ✅ Test dictionary operations (categories, search, get entries)

• ✅ Test model operations (search, get model, get revisions, export)

• ✅ Test search functionality

• ✅ Provide a detailed summary of all tests

Note: The test script uses your .env configuration and will skip tests that require existing data (like getting a specific model) if no data is found. This is expected behavior for a clean workspace.

API Documentation

For more information about the Signavio API, refer to the SAP Signavio Process Manager API Guide.