# simplifier-mcp

Connects an AI assistant to a Simplifier instance: connectors, business objects, data types and calls to external systems. Useful when you build apps on the low-code platform.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: simplifier-ag
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/simplifier-ag/simplifier-mcp
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/simplifier-mcp

## What it does

The server opens your Simplifier instance to the agent. It can browse and create connectors, handle logins, work with business objects and data types, run server-side JavaScript functions with parameters, and fire connector calls at outside systems. Platform documentation is reachable too.

Two surfaces carry the same data. Clients that speak MCP Resources read it through URIs such as `simplifier://businessobjects`, `simplifier://connector/{name}` or `simplifier://documentation/…`. Clients limited to MCP Tools get equivalent read access from `*-list`, `*-get`, `documentation-get` and `connector-wizard-rfc-search`. One implementation sits behind both, so results match; where both exist, resources win.

A token is required. The preferred option is a personal access token in `SIMPLIFIER_APITOKEN`, sent as the `ApiToken` header and stable across logins. You can instead set `SIMPLIFIER_TOKEN` or point `SIMPLIFIER_CREDENTIALS_FILE` at a JSON file holding `user` and `pass`. Only one of the three may be present. With `SIMPLIFIER_TOKEN` you have to drop the MCP config and re-add it after every Simplifier login, because the token rotates. REST, SOAP, SQL, SAPRFC and OData connectors are fully supported; OData is proxy-only and cannot run connector calls. On an on-premise install the DEV instance URL in `SIMPLIFIER_BASE_URL` follows a different pattern.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SIMPLIFIER_TOKEN`, `SIMPLIFIER_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add simplifier-mcp -e SIMPLIFIER_TOKEN=<SIMPLIFIER_TOKEN> -e SIMPLIFIER_BASE_URL=<SIMPLIFIER_BASE_URL> -- npx -y @simplifierag/simplifier-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add simplifier-mcp --env SIMPLIFIER_TOKEN=<SIMPLIFIER_TOKEN> --env SIMPLIFIER_BASE_URL=<SIMPLIFIER_BASE_URL> -- npx -y @simplifierag/simplifier-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "simplifier-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@simplifierag/simplifier-mcp"
            ],
            "env": {
                "SIMPLIFIER_TOKEN": "<SIMPLIFIER_TOKEN>",
                "SIMPLIFIER_BASE_URL": "<SIMPLIFIER_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "simplifier-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@simplifierag/simplifier-mcp"
            ],
            "env": {
                "SIMPLIFIER_TOKEN": "<SIMPLIFIER_TOKEN>",
                "SIMPLIFIER_BASE_URL": "<SIMPLIFIER_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SIMPLIFIER_TOKEN=<SIMPLIFIER_TOKEN> -e SIMPLIFIER_BASE_URL=<SIMPLIFIER_BASE_URL> simplifier-mcp npx -y @simplifierag/simplifier-mcp
```
Replace <…> with your own values

## When to use it
- list the connectors available in a Simplifier instance
- create a business object and run its function with arguments
- call an external system through a REST or SOAP connector
- inspect data type structures before wiring up an integration
- pull the right documentation page without leaving the agent

## Example prompts
- List every connector in my Simplifier instance
- Run the `OrderSync` business object function with these parameters
- Find the docs on setting up an SAPRFC connector

## Similar
- [cargo-connection](https://affpapa.org/en/nevibecode/skills/cargo-connection.md) — skill · 10400 installs
- [recoup-platform-api-access](https://affpapa.org/en/nevibecode/skills/recoup-platform-api-access.md) — skill · 4900 installs
- [prismatic-skills](https://affpapa.org/en/nevibecode/plugins/prismatic-skills.md) — plugin · ★ 28
- [genexus](https://affpapa.org/en/nevibecode/mcp/genexus.md) — MCP server · ★ 39
- [power-platform-connector](https://affpapa.org/en/nevibecode/rules/power-platform-connector.md) — rule · ★ 40451
- [docyrus-api-dev](https://affpapa.org/en/nevibecode/skills/docyrus-api-dev.md) — skill · 824 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md