Signavio MCP Server

An MCP (Model Context Protocol) server that exposes all Signavio API operations as tools for AI assistants.

Prerequisites

• Node.js (v14 or higher)

• npm or yarn

• Signavio account with API access

• Your Signavio tenant ID (Workspace ID)

Setup

1. Install dependencies:

   npm install

2. Configure environment variables:

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

   SIGNAVIO_BASE_URL=https://api.eu.signavio.cloud.sap SIGNAVIO_EMAIL=your-email@example.com SIGNAVIO_PASSWORD=your-password SIGNAVIO_TENANT=your-tenant-id

   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:

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

Start the MCP server:

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.