Simplifier

You can connect your Simplifier environment to an MCP server to manage connectors, business objects, data types, and external calls from AI assistants. This setup lets you execute business logic, run connector calls, and browse platform resources from your AI-powered workflow with consistent authentication and token-based access.

How to use

You will integrate an MCP client with your Simplifier instance to access and manage Connectors, BusinessObjects, and Data Types. Use the MCP client to connect securely, then perform actions such as executing JavaScript-based business logic, calling external systems through Connectors, and retrieving results. Start by adding the MCP configuration to your client, then restart your agent so it picks up the updated credentials.

Two common ways to run MCP clients are via a local npx/Node-based setup or through a Docker container. Pick the method that fits your environment, then provide your Simplifier token and base URL to authorize and connect.

If you sign in to Simplifier again, your token changes. In that case, remove the current MCP configuration from your client and re-add it with the new token, then restart your client to apply the changes.

How to install

Prerequisites: you need Node.js (for npx) or Docker to run the MCP server client. Ensure you have access to your Simplifier instance and a valid Simplifier token.

Choose one of the following methods to add the Simplifier MCP client to your setup.

Using Node / npx to run the MCP client locally:

{
  "mcpServers":  {
    "simplifier-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [ 
        "@simplifierag/simplifier-mcp@latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_TOKEN": "<your current simplifier token>"
      }
    }
  }
}

Using Docker to run the MCP client inside a container:

{
  "mcpServers": {
    "simplifier-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "SIMPLIFIER_TOKEN",
        "--env",
        "SIMPLIFIER_BASE_URL",
        "simplifierag/simplifier-mcp:latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_TOKEN": "<your current simplifier token>"
      }
    }
  }
}

After a new login to Simplifier

With every login to Simplifier your SimplifierToken will change. So you will have to: exit your AI agent, then remove the MCP configuration from your client, and then add the MCP again with the new token and restart your AI agent.

...or use this example configuration for your MCP client

You can place a configuration file in your project directory to reuse the MCP server settings.

Using Node / npx to reference the example config file directly in your project directory:

{
  "mcpServers":  {
    "simplifier-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@simplifierag/simplifier-mcp@latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_TOKEN": "<your current simplifier token>"
      }
    }
  }
}

Using Docker to reference the example config file directly in your project directory:

{
  "mcpServers": {
    "simplifier-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "SIMPLIFIER_TOKEN",
        "--env",
        "SIMPLIFIER_BASE_URL",
        "simplifierag/simplifier-mcp:latest"
      ],
      "env": {
        "SIMPLIFIER_BASE_URL": "https://<yourinstance>-dev.simplifier.cloud",
        "SIMPLIFIER_TOKEN": "<your current simplifier token>"
      }
    }
  }
}

Troubleshooting

If the MCP fails to connect to Simplifier on startup, an error page will open in your browser with details on the failure and information on how to fix the problem.

Available tools

Manage Connectors

Handle integration components that connect external systems to Simplifier, including setting up logins and credentials.

Manage BusinessObjects

Create and manage server-side JavaScript functions that implement business logic.

Manage Data Types

Define and manage the data structures used by Connectors and internal objects.

Execute Business Object Functions

Run JavaScript functions with parameters and obtain results.

Execute Connector Calls

Invoke external systems through Simplifier Connectors and retrieve responses.

Access platform resources

Browse connectors, business objects, data types, and system information within the MCP interface.