Procesio MCP Server

🚀 Procesio MCP Server

This is a server based on the Model Context Protocol (MCP) for interacting with the Procesio automation platform API. It allows language models and other MCP clients to list, view, and manage Procesio workflows and instances.

The server uses API Key/Value authentication.

✨ Features

Tools

The currently available tools are as follows:

• procesio_test_authentication:

  • Description: Test API Key/Value authentication by fetching the current user details.
  • Input: None
  • Output: A JSON object containing user details after successful authentication.

• procesio_list_projects:

  • Description: List available Procesio process templates (workflows).
  • Optional Input: pageNumber (integer, default is 1), pageItemCount (integer, default is 20)
  • Output: A JSON object containing a paginated list showing process templates.

• procesio_get_project_details:

  • Description: Get detailed information about a specific Procesio process template (workflow).
  • Required Input: projectId (string - UUID of the process template)
  • Output: A JSON object with detailed information about the specified process template configuration.

• procesio_launch_project:

  • Description: Launch an instance of a specific Procesio process template (workflow).
  • Required Input: projectId (string - UUID of the process template)
  • Optional Input: payload (object), runSynchronous (boolean), debugMode (boolean), secondsTimeOut (integer), connectionId (string - passed as a header)
  • Output: A JSON object containing details of the launched instance (e.g., instance ID). Note: Launch may fail if the project is invalid.

• procesio_get_instance_status:

  • Description: Get the status of a running or completed process instance.
  • Required Input: instanceId (string - UUID of the process instance)
  • Optional Input: projectId (string - project ID for filtering)
  • Output: A JSON object with status information about the specified instance.

📦 Installation

Configuration

To configure this server, follow these steps:

Configure via the .env file

PROCESIO_API_KEY=your_api_key_here
PROCESIO_API_SECRET=your_api_secret_here

Set in the MCP configuration file

{
    "procesio": {
        "apiKey": "your_api_key",
        "apiSecret": "your_api_secret"
    }
}

Project Building

npm install # Install dependencies

Local Running

npm run build # Build the project
node build/index.js # Start the server

The server will listen for MCP requests on standard input/output.

📄 License

This project is licensed under the Apache License, Version 2.0. For more details, see the LICENSE file.