Developers & AI

Want to use uCord with your AI of choice?

Copy this prompt into ChatGPT, Claude, Cursor or another assistant that supports MCP. It tells the assistant how to connect to uCord.

Set up the uCord MCP server for me. uCord is a directory of public Discord servers.
1. Read the full setup guide at https://ucord.cc/mcp.md and follow it.
2. Add a remote MCP server (Streamable HTTP) with the URL https://ucord.cc/mcp in my app's MCP settings. If you can't do that yourself, tell me exactly where to click or what to edit.
3. Test it by calling `list_top_servers` and showing me a few results, then tell me it's working.
4. When you recommend a server, link its uCord listing page, not a raw Discord invite.

Prefer to do it yourself? Read the setup guide or the REST API docs.

MCP server

Searching, browsing and the other basic features are free and need no login. Sign in only to manage your own listings, and for the few extras marked below.

Endpoint
https://ucord.cc/mcp
Transport
Streamable HTTP, one POST endpoint, JSON-RPC 2.0, stateless
Server card
/.well-known/mcp/server-card.json
Public, no sign-in (8)
  • search_servers Search uCord's directory of Discord servers by free text.
  • list_top_servers Browse listings without a search term, optionally restricted to a category or tags. Sign-in needed for sort newest or bumped.
  • get_server Full details for a single listing, by Discord guild ID or by its uCord vanity code. Sign-in needed for a vanity code identifier.
  • find_similar_servers Given one server, find others like it: shared tags (rarer shared tags count more), the same category, a similar size and uCord's ranking.
  • list_tags Every tag in use, with how many servers carry it, grouped by category.
  • list_categories The categories servers are grouped under, with per-tag listing counts.
  • get_advertising_info The public rate card: every ad spot on ucord.cc, where it sits, and its weekly and monthly price.
  • report_problem Tell uCord that something did not work.
Sign-in required (8)
  • get_server_reviews read Recent reviews left by uCord users for one listing, most helpful first.
  • get_site_stats read How big uCord is: listed servers, their combined members, vanity links and recent clicks - the same figures ucord.cc shows.
  • list_my_servers read Every server you manage in Discord that has a uCord listing, with its status: public, hidden, hidden_invite (unlisted because its invite died), hidden_bot_left, or banned.
  • get_listing_stats read Views, vanity-link clicks, joins, conversion and top referrers for one of your listings, against the previous period of the same length.
  • update_listing write Change any of the fields given; fields you leave out are untouched.
  • set_listing_visibility write public: true puts a finished listing in the directory (it needs descriptions and a vanity code; the error says what is missing).
  • bump_server write Bump a public listing to the top of the directory, under the same cooldown as /bump in Discord.
  • repair_invite write Check the listing's Discord invite and repair it if it is dead: the server's vanity URL, an existing or new permanent invite, or the server widget.

Sign-in

Sign in with Discord: your assistant opens uCord's sign-in when it first calls a sign-in tool, if it supports MCP sign-in. Apps that don't (Cursor, for one) can use a uCord API key from your dashboard instead, sent as Authorization: Bearer <key> or X-API-Key: <key>. Details in auth.md.

Client setup

Claude Code
claude mcp add --transport http ucord https://ucord.cc/mcp
Cursor ~/.cursor/mcp.json
{ "mcpServers": { "ucord": { "url": "https://ucord.cc/mcp" } } }
VS Code .vscode/mcp.json
{ "servers": { "ucord": { "type": "http", "url": "https://ucord.cc/mcp" } } }

Any other client: add a remote ("HTTP" or "Streamable HTTP") MCP server with the URL https://ucord.cc/mcp. The setup guide covers Claude, ChatGPT and API keys.

Limits

REST API

The same directory over plain HTTP at https://ucord.cc/api/v1, with JSON responses. Every endpoint needs an API key, made on your dashboard.

REST API docs

Docs for agents