Subo

Subo MCP server

Run your Discord community's forms, surveys, polls and quizzes by asking your AI app. Describe what you want to ask your members, and your AI app builds the project in Subo, checks the script, and launches it. You never open the dashboard.

Subo runs conversational surveys, forms, quizzes and polls natively in Discord and on the web. MCP (Model Context Protocol) is the open standard AI apps use to connect to outside tools. This repository holds the listing for the hosted Subo MCP server. The server itself runs on Subo's infrastructure, so there is nothing to install or host.

• Endpoint: https://api.subo.ai/mcp (streamable HTTP)
• Auth: sign in with OAuth (no key to copy), or send Authorization: Bearer sbo_live_… with a Subo API key
• Setup guide: https://subo.gg/blog/connect-discord-community-to-ai-agent/
• Registry name: gg.subo/survey-bot on the official MCP Registry

What your AI app can do

44 operations, covering essentially everything the Subo API can do, in one community:

• create, edit, clone, validate, open, close and delete projects (surveys and polls)
• write and edit a project's script block by block
• read responses and AI analysis
• manage members' XP and accomplishments
• browse and clone templates
• manage webhooks
• read and change community settings

What it deliberately cannot do

• create, rotate or delete API keys
• change who has access to your community
• connect a new verified-audience source, which needs a person to sign in

Every operation is labeled

Each operation carries one of four marks your AI app can read: read-only, normal change, Outward (it reaches real people, such as launching a project or granting XP a member will see), or Destructive (it deletes something). A well-behaved AI app asks you before Outward and Destructive calls. Subo also enforces its own rules regardless of what the agent does: a project that is still open cannot be deleted through the API at all.

Connect it

Connecting takes the Admin role in the community. You choose whether the connection gets Admin or Creator access, so you can give the agent a narrower reach than your own.

Sign in with OAuth (claude.ai, Claude Desktop, Claude Code and other OAuth-capable apps)

No API key to create or paste.

1. Add the server. In claude.ai or Claude Desktop, open Settings → Connectors → Add custom connector and enter https://api.subo.ai/mcp. In Claude Code, run this in a terminal, then restart Claude Code:

   claude mcp add --transport http --scope user subo https://api.subo.ai/mcp
   

2. Sign in. Click Connect (in Claude Code, type /mcp and choose subo to authenticate). Your browser opens Subo: sign in with Discord, pick the community, pick Admin or Creator access, and approve.

3. Check it. Ask your AI app to list your Subo projects. In Claude Code, /mcp should show subo as connected.

The connection appears on the Account page of the Subo web app (https://app.subo.gg/app/account) under API Access, marked "Connected through OAuth". Revoke it there at any time. A connection unused for 90 days asks you to sign in again.

Use an API key (any app that can send a custom header)

1. Create a key. On the Account page (https://app.subo.gg/app/account), go to API Access and create a key. Under "This key represents", choose Bot or agent, and pick its access level. The confirmation panel shows the config with your key already in it.

2. Add the connection. Claude Code (run in a terminal, not in a chat, then restart Claude Code):

   claude mcp add --transport http --scope user subo https://api.subo.ai/mcp --header "Authorization: Bearer sbo_live_…"
   

   Other AI apps: add a remote (HTTP) server with a custom header. The config usually looks like this, though the file location and the name of the outer key vary by app:

   {
     "mcpServers": {
       "subo": {
         "type": "http",
         "url": "https://api.subo.ai/mcp",
         "headers": { "Authorization": "Bearer sbo_live_…" }
       }
     }
   }
   

3. Check it. In Claude Code, type /mcp: subo should show as connected, with 44 tools.

We have tested Subo from claude.ai, Claude Code and Grok Bot. The full walkthrough, including key safety and troubleshooting, is at https://subo.gg/blog/connect-discord-community-to-ai-agent/.

Keep your connection safe

Whichever way you connect, one connection equals one community, and it acts with the access its owner has right now. With OAuth there is no key for you to handle. With an API key, keep it in your AI app's configuration file and out of chats, documents and screenshots. Either way, revoke a connection on the Account page if you no longer trust it.

Plans

Every plan that can create an API key includes the MCP server, with nothing extra to buy or enable. Requests share the Public API rate limit for your plan. See https://subo.gg/pricing/.

More

• Announcement: https://subo.gg/blog/subo-mcp-server/
• API quickstart and recipes: https://subo.gg/api/
• For AI agents: https://subo.gg/llms.txt
• Support: https://subo.gg/support/