LearnWorlds

Name: LearnWorlds
Author: ohneben

ohneben

ohneben's Model Context Protocol server for the LearnWorlds API — all 94 endpoints as safety-categorized MCP tools (read-only / write / destructive). Runs over stdio or Streamable HTTP, with Docker, retries, and rate limiting.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add learnworlds --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env LEARNWORLDS_BASE_URL='<LEARNWORLDS_BASE_URL>' --env LEARNWORLDS_API_TOKEN='<LEARNWORLDS_API_TOKEN>' --env LEARNWORLDS_CLIENT_ID='<LEARNWORLDS_CLIENT_ID>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- docker run -i --rm -e MCP_TRANSPORT -e LEARNWORLDS_BASE_URL -e LEARNWORLDS_API_TOKEN -e LEARNWORLDS_CLIENT_ID -e MCP_AUTH_TOKEN ghcr.io/ohneben/learnworlds-mcp:1.1.2

~/.codex/config.toml

[mcp_servers.learnworlds]
command = "docker"
args = ["run", "-i", "--rm", "-e", "MCP_TRANSPORT", "-e", "LEARNWORLDS_BASE_URL", "-e", "LEARNWORLDS_API_TOKEN", "-e", "LEARNWORLDS_CLIENT_ID", "-e", "MCP_AUTH_TOKEN", "ghcr.io/ohneben/learnworlds-mcp:1.1.2"]
env = { MCP_TRANSPORT = "<MCP_TRANSPORT>", LEARNWORLDS_BASE_URL = "<LEARNWORLDS_BASE_URL>", LEARNWORLDS_API_TOKEN = "<LEARNWORLDS_API_TOKEN>", LEARNWORLDS_CLIENT_ID = "<LEARNWORLDS_CLIENT_ID>", MCP_AUTH_TOKEN = "<MCP_AUTH_TOKEN>" }

# codex mcp add learnworlds --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env LEARNWORLDS_BASE_URL='<LEARNWORLDS_BASE_URL>' --env LEARNWORLDS_API_TOKEN='<LEARNWORLDS_API_TOKEN>' --env LEARNWORLDS_CLIENT_ID='<LEARNWORLDS_CLIENT_ID>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- docker run -i --rm -e MCP_TRANSPORT -e LEARNWORLDS_BASE_URL -e LEARNWORLDS_API_TOKEN -e LEARNWORLDS_CLIENT_ID -e MCP_AUTH_TOKEN ghcr.io/ohneben/learnworlds-mcp:1.1.2

~/.cursor/mcp.json

{
  "mcpServers": {
    "learnworlds": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "LEARNWORLDS_BASE_URL",
        "-e",
        "LEARNWORLDS_API_TOKEN",
        "-e",
        "LEARNWORLDS_CLIENT_ID",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/learnworlds-mcp:1.1.2"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "LEARNWORLDS_BASE_URL": "<LEARNWORLDS_BASE_URL>",
        "LEARNWORLDS_API_TOKEN": "<LEARNWORLDS_API_TOKEN>",
        "LEARNWORLDS_CLIENT_ID": "<LEARNWORLDS_CLIENT_ID>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "learnworlds": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "LEARNWORLDS_BASE_URL",
        "-e",
        "LEARNWORLDS_API_TOKEN",
        "-e",
        "LEARNWORLDS_CLIENT_ID",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/learnworlds-mcp:1.1.2"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "LEARNWORLDS_BASE_URL": "<LEARNWORLDS_BASE_URL>",
        "LEARNWORLDS_API_TOKEN": "<LEARNWORLDS_API_TOKEN>",
        "LEARNWORLDS_CLIENT_ID": "<LEARNWORLDS_CLIENT_ID>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "learnworlds": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "LEARNWORLDS_BASE_URL",
        "-e",
        "LEARNWORLDS_API_TOKEN",
        "-e",
        "LEARNWORLDS_CLIENT_ID",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/learnworlds-mcp:1.1.2"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "LEARNWORLDS_BASE_URL": "<LEARNWORLDS_BASE_URL>",
        "LEARNWORLDS_API_TOKEN": "<LEARNWORLDS_API_TOKEN>",
        "LEARNWORLDS_CLIENT_ID": "<LEARNWORLDS_CLIENT_ID>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "learnworlds": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "LEARNWORLDS_BASE_URL",
        "-e",
        "LEARNWORLDS_API_TOKEN",
        "-e",
        "LEARNWORLDS_CLIENT_ID",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/learnworlds-mcp:1.1.2"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "LEARNWORLDS_BASE_URL": "<LEARNWORLDS_BASE_URL>",
        "LEARNWORLDS_API_TOKEN": "<LEARNWORLDS_API_TOKEN>",
        "LEARNWORLDS_CLIENT_ID": "<LEARNWORLDS_CLIENT_ID>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "learnworlds": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "LEARNWORLDS_BASE_URL",
        "-e",
        "LEARNWORLDS_API_TOKEN",
        "-e",
        "LEARNWORLDS_CLIENT_ID",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/learnworlds-mcp:1.1.2"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "LEARNWORLDS_BASE_URL": "<LEARNWORLDS_BASE_URL>",
        "LEARNWORLDS_API_TOKEN": "<LEARNWORLDS_API_TOKEN>",
        "LEARNWORLDS_CLIENT_ID": "<LEARNWORLDS_CLIENT_ID>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Environment variables

MCP_TRANSPORT
LEARNWORLDS_BASE_URL
LEARNWORLDS_API_TOKEN
LEARNWORLDS_CLIENT_ID
MCP_AUTH_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related