This server lets AI assistants manage Top.gg listings (Discord bots, Discord servers, or Roblox games) via the Top.gg v1 API using the Model Context Protocol.
Retrieve project info (get_project): Fetch details of the project associated with your API token.
Update listing (update_project): Modify the headline (3–140 chars) and page content (300–50,000 chars) with support for multiple locales (e.g., en, de, fr, ja).
Register Discord slash commands (register_commands): Replace all slash commands for your bot project; passing an empty array clears them all.
Fetch vote history (get_votes): Retrieve paginated, cursor-based vote history starting from a specified date (up to 1 year ago).
Check user vote status (check_user_vote): Determine if a specific user has voted, with support for Top.gg and Discord ID namespaces.
Submit metrics (post_metrics): Post a single metrics update — Discord bot (server/shard counts), Discord server (member/online counts), or Roblox game (player count).
Batch submit metrics (post_metrics_batch): Send up to 100 timestamped metrics entries in a single request.
Create announcements (create_announcement): Publish categorized announcements (announcement, event, new_feature) with a title (3–100 chars) and content (10–2,000 chars), limited to one every 4 hours.
Provides tools for managing Top.gg bot or server listings, including retrieving project info, updating page content (per locale), registering Discord slash commands, fetching vote history, checking user votes, submitting metrics (server count, player count, etc.), and creating announcements.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@topgg-mcp get my bot's latest votes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol server for the Top.gg v1 API, letting AI assistants manage a Top.gg Discord bot, Discord server, or Roblox game listing directly.
Tool | Description |
| Retrieve the project associated with your token |
| Update headline and page content (per locale) |
| Replace registered Discord slash commands (empty clears all) |
| Fetch paginated vote history (cursor-based) |
| Check whether a specific user has voted |
| Submit Discord bot/server or Roblox game metrics |
| Submit up to 100 metrics entries in one request |
| Post a categorized project announcement (1 per 4 hours) |
Related MCP server: StashDog MCP Server
Node.js 22+
A Top.gg API token (obtained from your Top.gg dashboard)
Set TOPGG_TOKEN to your API token. The project parameter on every tool is optional and can be omitted.
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"topgg": {
"command": "npx",
"args": ["-y", "topgg-mcp"],
"env": {
"TOPGG_TOKEN": "your-token-here"
}
}
}
}Claude Code:
claude mcp add topgg -e TOPGG_TOKEN=your-token-here -- npx -y topgg-mcpUse TOPGG_TOKEN_<NAME> for each project. The suffix becomes the name used in the project parameter (lowercased). When multiple tokens are configured, the project parameter is required on every tool call.
{
"mcpServers": {
"topgg": {
"command": "npx",
"args": ["-y", "topgg-mcp"],
"env": {
"TOPGG_TOKEN_MYBOT": "token-for-mybot",
"TOPGG_TOKEN_OTHERBOT": "token-for-otherbot"
}
}
}
}With the above config, pass "project": "mybot" or "project": "otherbot" in every tool call.
You can also mix TOPGG_TOKEN (name: "default") with named tokens if needed.
The server targets the Top.gg v1 REST API (https://top.gg/api/v1). All requests are authenticated with Authorization: Bearer <token>. API errors are surfaced as readable tool errors using the RFC 7807 problem details format returned by Top.gg.
Method | Endpoint | Tool |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rate limits (enforced by Top.gg, not this server):
100 requests/second globally
60 requests/minute for bot endpoints
Violations result in a 1-hour block
Announcement cooldown responses include the API's Retry-After value in the tool error
pnpm install
pnpm build # compile to dist/
pnpm typecheck # TypeScript strict check
pnpm lint # ESLint
pnpm format # Prettier
pnpm test # Vitest (no live API required)
pnpm test:coverageTests use fetch mocks — no TOPGG_TOKEN is needed to run them.
ISC
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
List, configure, chat with, analyse and embed your Echo AI assistants.
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Paillat-dev/topgg-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server