Skip to content

New: the Lumo app for iPhone and Android

App StoreGoogle Play

Lumo and AI apps

Control Lumo with your AI

Connect Lumo to Claude, ChatGPT, Gemini, Grok, Copilot, Cursor, and many other AI apps. Then just say what you want, like "Create an announcements channel and enable the welcome message", and your AI handles it through Lumo. Always with your own permissions.

MCP server address

https://lumobot.net/mcp

Quickstart: Connected in three steps

  1. 1. Enter address

    Add a custom MCP server or connector in your AI app using the address above.

  2. 2. Log in with Discord

    Your app opens lumobot.net. You log in with Discord, choose your server and permissions, and approve.

  3. 3. Get started

    Ask your AI about your servers or give it a task. You can disconnect anytime in your account.

Works with

All apps supporting remote MCP servers via Streamable HTTP. We tested setup for these:

Pricing

Read: for all servers. Viewing servers, settings, roles, channels, tickets, and statistics is included even with the Free plan.

Change and act: Premium and above. Changing settings, assigning roles, creating channels, moderating, answering tickets, and sending messages requires Premium, Partner, or Pro on the respective server.

View plans

Two ways to sign in

Sign in with Discord (OAuth). The easiest way for Claude, ChatGPT, Gemini CLI, Copilot, Cursor, and all apps with OAuth. No copying required.

Personal access key. For apps without OAuth and custom programs. Generate the key in your account under "Connected AI Apps" and include it as a header: Authorization: Bearer lmo_sk_…

Open connected AI apps

As secure as the dashboard

  • Your AI never has more permissions than you. Lumo checks your dashboard access, Discord permissions, and role hierarchy with every call.
  • Dangerous actions like bans, deletions, or granting high permissions are only executed once you explicitly confirm them in your app. The confirmation expires after 5 minutes.
  • Every change is recorded in the Lumo log and the Discord audit log with the note "via app (MCP) by person".
  • Lumo marks text from your server (messages, names) as data for your AI, not as instructions. Still, always review what your AI suggests.

Guides

Replace lmo_sk_… with your personal key if you do not sign in with Discord.

Claude

DirectShow steps

Settings > Connectors > Add custom connector. Name "Lumo", enter address above, Add and sign in with Discord. The connector also works in Claude Desktop and the Claude app. One custom connector is available on the Free plan.

  1. Open claude.ai or the Claude app and go to Settings > Connectors.
  2. Click "Add custom connector".
  3. Name: Lumo. URL: paste the address above. Add.
  4. Click Connect and sign in with Discord on lumobot.net.
  5. Select server and permissions, check the box, and click Authorize.

Claude Code

DirectShow steps

Run in your terminal, then open /mcp and sign in. Use the second line with your key instead of signing in.

  1. Copy the command and run it in the terminal.
  2. Start Claude Code and type /mcp.
  3. Select lumo and sign in with Discord.
claude mcp add --transport http lumo https://lumobot.net/mcp
# mit Schlüssel / with key:
claude mcp add --transport http lumo https://lumobot.net/mcp --header "Authorization: Bearer lmo_sk_…"

ChatGPT

DirectShow steps

In ChatGPT select "Add custom MCP server" (Settings, Apps or Plugins, depending on version), enter address above, choose "OAuth" login and confirm with Discord. ChatGPT does not support a static key there.

  1. In ChatGPT, open Settings and look for "Add custom MCP server" (depending on the version under Apps or Plugins, in developer mode).
  2. Name: Lumo. Server URL: the address above.
  3. Sign-in: choose OAuth and confirm.
  4. Sign in with Discord on lumobot.net and click Authorize.
  5. Select Lumo in the chat using @.

Gemini CLI

DirectShow steps

Add to .gemini/settings.json (project) or ~/.gemini/settings.json. Without headers, Gemini CLI starts Discord sign-in automatically.

  1. Open ~/.gemini/settings.json (or .gemini/settings.json in the project).
  2. Paste the configuration and save.
  3. Start Gemini CLI. Sign-in with Discord starts automatically.
{
  "mcpServers": {
    "lumo": {
      "httpUrl": "https://lumobot.net/mcp"
    }
  }
}

Grok

DirectShow steps

On grok.com under Connectors create a custom connector with the address above and sign in. On Business and Enterprise accounts an admin sets it up first.

  1. Open grok.com and go to Connectors.
  2. Create a new custom connector with the address above.
  3. Sign in with Discord and allow access.

Mistral Le Chat

DirectShow steps

In Le Chat under Connectors > Add connector > Custom MCP connector. Name without spaces, enter address, Connect. Le Chat detects OAuth automatically.

  1. In Le Chat, open Connectors > Add connector.
  2. Select "Custom MCP connector", name lumo, address above.
  3. Click Connect and sign in with Discord.

Microsoft Copilot Studio

DirectShow steps

In Copilot Studio: Tools > Add tool > New tool > Model Context Protocol. Enter address and choose login "OAuth 2.0, dynamic discovery", or API key as header Authorization with value Bearer lmo_sk_…

  1. In Copilot Studio, open Tools > Add tool > New tool > Model Context Protocol.
  2. Enter name, description, and the address above.
  3. Sign-in: OAuth 2.0, dynamic discovery. Create and connect.

GitHub Copilot (VS Code)

DirectShow steps

GitHub Copilot in VS Code: add to .vscode/mcp.json. Without headers, VS Code prompts for login on first launch.

  1. Create the file .vscode/mcp.json in the project.
  2. Paste the configuration and save.
  3. Click Start above the entry. VS Code will ask to sign in.
{
  "servers": {
    "lumo": {
      "type": "http",
      "url": "https://lumobot.net/mcp"
    }
  }
}

Cursor

DirectShow steps

Add to ~/.cursor/mcp.json. With url only, Cursor logs in via OAuth.

  1. Open ~/.cursor/mcp.json (or Settings > MCP > New Server).
  2. Paste the configuration and save.
  3. Cursor asks to sign in. Sign in with Discord.
{
  "mcpServers": {
    "lumo": {
      "url": "https://lumobot.net/mcp"
    }
  }
}

Windsurf

DirectShow steps

In Windsurf (Devin Desktop) add to mcp_config.json. OAuth is supported.

  1. Open Windsurf's mcp_config.json file.
  2. Paste the configuration and save.
  3. Reload the MCP servers in Windsurf and sign in.
{
  "mcpServers": {
    "lumo": {
      "serverUrl": "https://lumobot.net/mcp"
    }
  }
}

Zed

DirectShow steps

In Zed settings add under context_servers. Without Authorization header, Zed starts the login.

  1. Open Zed settings (settings.json).
  2. Insert the context_servers section.
  3. Zed starts sign-in if you do not enter a key.
"context_servers": {
  "lumo": {
    "url": "https://lumobot.net/mcp"
  }
}

Cline

DirectShow steps

Add to cline_mcp_settings.json, type streamableHttp is required.

  1. In Cline, open the MCP server settings (cline_mcp_settings.json).
  2. Paste the configuration; type streamableHttp is important.
  3. Insert your key and save.
{
  "mcpServers": {
    "lumo": {
      "type": "streamableHttp",
      "url": "https://lumobot.net/mcp",
      "headers": {
        "Authorization": "Bearer lmo_sk_…"
      }
    }
  }
}

LM Studio

DirectShow steps

In LM Studio: App > Install > edit mcp.json. Login with key only.

  1. In LM Studio, open App > Install > Edit mcp.json.
  2. Paste the configuration and insert your key.
  3. Save, done.
{
  "mcpServers": {
    "lumo": {
      "url": "https://lumobot.net/mcp",
      "headers": {
        "Authorization": "Bearer lmo_sk_…"
      }
    }
  }
}

Perplexity

DirectShow steps

Plugins > Add custom > MCP connector > Remote. Enter address, choose Streamable HTTP and OAuth under Advanced.

  1. Open Plugins > Add custom > MCP Connector > Remote.
  2. Enter the address; under Advanced, select Streamable HTTP and OAuth.
  3. Add and sign in with Discord.

Raycast

DirectShow steps

Open "Install MCP Server", transport HTTP, enter address and choose OAuth "Dynamic", or enter the header with key.

  1. Open "Install MCP Server" in Raycast.
  2. Transport HTTP, enter the address above.
  3. Select OAuth "Dynamic" and sign in, or enter the header with your key.

Zapier (MCP Client)

DirectShow steps

Apps > Add connection > MCP Client. Enter address, transport Streamable HTTP, and key as Bearer Token (Beta).

  1. Apps > Add connection > MCP Client.
  2. Enter address, transport Streamable HTTP.
  3. Enter key as Bearer Token.

Claude Desktop (Konfigurationsdatei / config file)

ExperimentalShow steps
  1. In Claude Desktop, open Settings > Developer > Edit Config.
  2. Paste the configuration and replace lmo_sk_… with your key.
  3. Restart Claude Desktop. It is easier via Connectors like in Claude.
{
  "mcpServers": {
    "lumo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://lumobot.net/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer lmo_sk_…"
      }
    }
  }
}

Continue

ExperimentalShow steps

Add to config.yaml. Login with key only.

  1. Open Continue's config.yaml.
  2. Insert the mcpServers section and enter your key.
  3. Save and reload Continue.
mcpServers:
  - name: lumo
    type: streamable-http
    url: https://lumobot.net/mcp
    requestOptions:
      headers:
        Authorization: Bearer lmo_sk_…

n8n (MCP Client Tool)

ExperimentalShow steps

In AI Agent use the "MCP Client Tool" node, transport "HTTP Streamable", auth Bearer with key. Older n8n versions only support SSE.

  1. In AI Agent, add the "MCP Client Tool" node.
  2. Endpoint: the address above, transport HTTP Streamable.
  3. Bearer authentication with your key.

Gemini Enterprise

ExperimentalShow steps

Gemini Enterprise: data store "Custom MCP Server" (Preview). Requires Google Cloud admin permissions and an organization policy.

Claude API

For developersShow steps

For custom programs with the Claude API (MCP connector).

"mcp_servers": [{ "type": "url", "url": "https://lumobot.net/mcp", "name": "lumo", "authorization_token": "lmo_sk_…" }],
"tools": [{ "type": "mcp_toolset", "mcp_server_name": "lumo" }]
// Header: anthropic-beta: mcp-client-2025-11-20

OpenAI Responses API

For developersShow steps

For custom programs with the OpenAI Responses API.

{ "type": "mcp", "server_label": "lumo", "server_url": "https://lumobot.net/mcp", "authorization": "lmo_sk_…", "require_approval": "always" }

Gemini API

For developersShow steps

Via the Gemini API (Interactions) as a remote MCP server with key. The name must not contain a hyphen.

{ "type": "mcp_server", "name": "lumo", "url": "https://lumobot.net/mcp", "headers": { "Authorization": "Bearer lmo_sk_…" } }

xAI API (Grok)

For developersShow steps

In the xAI API as a remote MCP tool with key.

{ "type": "mcp", "server_url": "https://lumobot.net/mcp", "server_label": "lumo", "authorization": "lmo_sk_…" }

ChatGPT GPT Actions (OpenAPI)

For developersShow steps

For custom GPTs: Add action, import schema from the OpenAPI address, authentication "API Key", type "Bearer", paste key. According to OpenAI, custom GPTs expire on 12/11/2026.

curl -H "Authorization: Bearer lmo_sk_…" https://lumobot.net/api/v1/lumo/openapi.json -o lumo-openapi.json

Try this out

  • „Show me my Lumo servers and which plan they have.“
  • „Create a VIP role and give it to @Max.“
  • „Show me the open tickets and summarize them briefly.“
  • „Turn on greetings and write a friendly welcome message.“
  • „Create an announcement channel that only the team can post in.“
  • „What changed in Lumo over the last few days?“
  • „Add Lumo to my new server and set up the welcome message and tickets.“

Lumo can also help you directly: Ask him on Discord "How do I connect you to ChatGPT?".

Common issues

Add Lumo to a new server with your AI

Tell your AI "Add Lumo to my new server". It gives you an invite link. Pick the server in Discord and confirm it yourself, Discord requires that. Then your AI checks that Lumo is there and sets it up with you.

Login fails or the window closes

Allow pop-ups for your AI app, sign in to lumobot.net with the Discord account that has dashboard access, and restart the connection in the app. The request is valid for 10 minutes.

The app shows no tools

Disconnect in the app and reconnect, or reload the app. Check that the address is exactly https://lumobot.net/mcp.

Response "plan_required" when making changes

Reading is free. To make changes and take action, the server needs Premium, Partner, or Pro. Lumo includes the upgrade link right away.

Response "denied", "no_access", or "no_full_access"

Your AI is missing your permissions: You need dashboard access on the server and the corresponding Discord permission. Some features (member data, Discord management) require full access.

Response "scope"

The connection is read-only. Reconnect and keep "Make changes and act" enabled, or create a key with edit permissions.

The app asks for a key

Generate it in your account under "Connected AI Apps" or ask Lumo on Discord: "Create an access key for my AI". It will be sent via DM.

What your AI can do with Lumo

17 tools. All verify your permissions automatically.

  • list_serversYour servers with Lumo, plan, and accessFree
  • get_server_overviewOverview: modules, plan, AI quota, voice minutes, Lumo permissionsFree
  • get_settingsRead settings for every module, just like in the dashboardFree
  • get_server_structureRoles and channelsFree
  • discord_readRead Discord management: roles, channels, invites, bans, emojis, AutoMod, audit log, webhooks, eventsFreePersonal data
  • search_membersSearch membersFreePersonal data
  • get_memberMember roles, join date, and warningsFreePersonal data
  • list_ticketsOpen ticketsFreePersonal data
  • read_ticketRead ticketFreePersonal data
  • add_serverAdd Lumo to a new server (ready invite link, you confirm in Discord)Free
  • check_server_addedCheck whether Lumo was added and continue with the setupFree
  • create_support_requestContact the Lumo team (only for real problems, with your consent, diagnostics added automatically)Free
  • get_support_requestsYour support requests and the answersFree
  • reply_support_requestReply to your own support requestFree
  • list_giveawaysGiveawaysFree
  • get_statisticsStatistics up to 90 daysFree
  • get_change_logLumo log: who changed whatFree
  • list_teamsYour Lumo TeamsFree
  • update_settingsChange settings, with the same verification as in the dashboardFrom Premium
  • run_actionAssign roles, create channels, send messages, moderation, tickets, giveaways, custom commandsFrom Premium
  • discord_manageManage Discord: roles, channels, permissions, servers, invites, emojis, AutoMod, eventsFrom Premium
  • reply_ticketAnswer and close ticketsFrom PremiumPersonal data

How confirmation works

For dangerous actions, Lumo responds with status "bestaetigung_noetig" and an ID. Your AI will then ask you. Only once you approve, it calls the same tool again with bestaetigt=true and the ID.

For AIs without MCP: OpenAPI interface

The same tools are available as a REST API with the same permission and tier checks. This lets you integrate Lumo as a custom GPT action, as a function call in Gemini or Grok, or into your own agents. Authenticate using your personal key as Bearer.

curl -H "Authorization: Bearer lmo_sk_…" https://lumobot.net/api/v1/lumo/openapi.json -o lumo-openapi.json

The schema is only available with your key: download it with the command above and import the file.

Example

curl -X POST https://lumobot.net/api/v1/lumo/list_servers \
  -H "Authorization: Bearer lmo_sk_…" \
  -H "Content-Type: application/json" -d '{}'

Privacy

The connection is disabled until you set it up yourself and give your explicit consent. Anything your AI retrieves through Lumo is sent to the provider of your AI app and processed according to their terms. Lumo does not control what this service does with it. We only store who agreed to which app and when, along with the timestamp of last use, never any content.

Technical details: MCP over Streamable HTTP (protocol 2026-07-28 and older versions from 2025-03-26), OAuth 2.1 with PKCE, Dynamic Client Registration and Client ID Metadata Documents, metadata at /.well-known/oauth-protected-resource/mcp.