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/mcpQuickstart: Connected in three steps
1. Enter address
Add a custom MCP server or connector in your AI app using the address above.
2. Log in with Discord
Your app opens lumobot.net. You log in with Discord, choose your server and permissions, and approve.
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:
- Claude
- Claude Code
- ChatGPT
- Gemini CLI
- Grok
- Mistral Le Chat
- Microsoft Copilot Studio
- GitHub Copilot (VS Code)
- Cursor
- Windsurf
- Zed
- Cline
- LM Studio
- Perplexity
- Raycast
- Zapier (MCP Client)
- Claude Desktop (Konfigurationsdatei / config file)Experimental
- ContinueExperimental
- n8n (MCP Client Tool)Experimental
- Gemini EnterpriseExperimental
- Claude APIFor developers
- OpenAI Responses APIFor developers
- Gemini APIFor developers
- xAI API (Grok)For developers
- ChatGPT GPT Actions (OpenAPI)For developers
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 plansTwo 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 appsAs 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.
- Open claude.ai or the Claude app and go to Settings > Connectors.
- Click "Add custom connector".
- Name: Lumo. URL: paste the address above. Add.
- Click Connect and sign in with Discord on lumobot.net.
- 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.
- Copy the command and run it in the terminal.
- Start Claude Code and type /mcp.
- 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.
- In ChatGPT, open Settings and look for "Add custom MCP server" (depending on the version under Apps or Plugins, in developer mode).
- Name: Lumo. Server URL: the address above.
- Sign-in: choose OAuth and confirm.
- Sign in with Discord on lumobot.net and click Authorize.
- 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.
- Open ~/.gemini/settings.json (or .gemini/settings.json in the project).
- Paste the configuration and save.
- 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.
- Open grok.com and go to Connectors.
- Create a new custom connector with the address above.
- 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.
- In Le Chat, open Connectors > Add connector.
- Select "Custom MCP connector", name lumo, address above.
- 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_…
- In Copilot Studio, open Tools > Add tool > New tool > Model Context Protocol.
- Enter name, description, and the address above.
- 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.
- Create the file .vscode/mcp.json in the project.
- Paste the configuration and save.
- 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.
- Open ~/.cursor/mcp.json (or Settings > MCP > New Server).
- Paste the configuration and save.
- 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.
- Open Windsurf's mcp_config.json file.
- Paste the configuration and save.
- 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.
- Open Zed settings (settings.json).
- Insert the context_servers section.
- 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.
- In Cline, open the MCP server settings (cline_mcp_settings.json).
- Paste the configuration; type streamableHttp is important.
- 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.
- In LM Studio, open App > Install > Edit mcp.json.
- Paste the configuration and insert your key.
- 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.
- Open Plugins > Add custom > MCP Connector > Remote.
- Enter the address; under Advanced, select Streamable HTTP and OAuth.
- 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.
- Open "Install MCP Server" in Raycast.
- Transport HTTP, enter the address above.
- 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).
- Apps > Add connection > MCP Client.
- Enter address, transport Streamable HTTP.
- Enter key as Bearer Token.
Claude Desktop (Konfigurationsdatei / config file)
ExperimentalShow steps
- In Claude Desktop, open Settings > Developer > Edit Config.
- Paste the configuration and replace lmo_sk_… with your key.
- 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.
- Open Continue's config.yaml.
- Insert the mcpServers section and enter your key.
- 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.
- In AI Agent, add the "MCP Client Tool" node.
- Endpoint: the address above, transport HTTP Streamable.
- 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-20OpenAI 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.jsonTry 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 accessFreeget_server_overviewOverview: modules, plan, AI quota, voice minutes, Lumo permissionsFreeget_settingsRead settings for every module, just like in the dashboardFreeget_server_structureRoles and channelsFreediscord_readRead Discord management: roles, channels, invites, bans, emojis, AutoMod, audit log, webhooks, eventsFreePersonal datasearch_membersSearch membersFreePersonal dataget_memberMember roles, join date, and warningsFreePersonal datalist_ticketsOpen ticketsFreePersonal dataread_ticketRead ticketFreePersonal dataadd_serverAdd Lumo to a new server (ready invite link, you confirm in Discord)Freecheck_server_addedCheck whether Lumo was added and continue with the setupFreecreate_support_requestContact the Lumo team (only for real problems, with your consent, diagnostics added automatically)Freeget_support_requestsYour support requests and the answersFreereply_support_requestReply to your own support requestFreelist_giveawaysGiveawaysFreeget_statisticsStatistics up to 90 daysFreeget_change_logLumo log: who changed whatFreelist_teamsYour Lumo TeamsFreeupdate_settingsChange settings, with the same verification as in the dashboardFrom Premiumrun_actionAssign roles, create channels, send messages, moderation, tickets, giveaways, custom commandsFrom Premiumdiscord_manageManage Discord: roles, channels, permissions, servers, invites, emojis, AutoMod, eventsFrom Premiumreply_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.jsonThe 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.