Skip to content

How Discord’s scores are calculated

The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.

verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10

PA Score23/100

Agent-ready 59.4 × 0.30 = 17.82

API quality 0.0 × 0.20 = 0.00

Openness 12.0 × 0.20 = 2.40

Built-in AI 6.7 × 0.15 = 1.00

Automation 14.4 × 0.15 = 2.16

(17.82 + 0.00 + 2.40 + 1.00 + 2.16) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 23.38 ÷ 1.00 = 23.4

Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.

Agent-ready59.4/100×0.30 of the PA blend

Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.

Point an agent at llms.txt or agent-oriented docsweight 2

2 (weight) × 9 (quality) × 1.0 (full) = 18.0 of 20 max

  • [probe] https://docs.discord.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.discord.com/llms.txt # Documentation - Discord - [Discord Developer Platform](https://docs.discord.com/developers/intro.md): Build bots and
  • [probe] https://docs.discord.com/developers/intro.mdPROBE docs-md: HTTP 200 at https://docs.discord.com/developers/intro.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.discord.com/llms.txt > Use this file

Run the product headlessly / in CI for automationweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdCI/CD pipelines posting build results or deployment notifications
  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdSend messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookWebhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token
  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.

Plug MCP servers into this product so it can use their toolsweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Connect an agent via an official MCP serverweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Use an official CLIweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Drive the product through a documented public APIweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild
  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookWebhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewSlash commands are the most common type of command and are accessed by typing `/` in the chat input, or by opening the command picker.
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild, like when a channel is updated or a role is created.
  • [probe] https://docs.discord.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.discord.com/openapi.json, https://docs.discord.com/swagger.json, https://docs.discord.com/api/openapi.json, https://docs.discord.com/.well-known/openapi.json)

Issue scoped/least-privilege API credentials for an agentweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token
  • [claimed-docs] https://docs.discord.com/developers/topics/oauth2The first step in implementing OAuth2 is registering a developer application and retrieving your client ID and client secret.
  • [claimed-docs] https://docs.discord.com/developers/referenceUsing a bot token found on the Bot page within your app’s settings... Using an OAuth2 bearer token gained through the OAuth2 API.
  • [claimed-docs] https://docs.discord.com/developers/topics/oauth2OAuth2 enables application developers to build applications that utilize authentication and data from the Discord API.
  • [claimed-docs] https://docs.discord.com/developers/topics/oauth2allows /users/@me/connections to return linked third-party accounts

Build against official SDKsweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild
  • [claimed-docs] https://discord.com/developers/buildOur Embedded App SDK makes it quick and easy to ship native web apps, games, and interactive experiences.
  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.
  • [claimed-docs] https://docs.discord.com/developers/discord-social-sdk/getting-started.mdallowing them to connect with their friends and communities on Discord without leaving your game
  • [claimed-docs] https://docs.discord.com/developers/discord-social-sdk/getting-started/using-unity.mdThis guide will walk you through integrating the Discord Social SDK into a Unity project.
  • [claimed-docs] https://docs.discord.com/developers/discord-social-sdk/getting-started/using-c++.mdGet started with the Discord Social SDK in C++ applications.
  • [claimed-docs] https://docs.discord.com/developers/discord-social-sdk/getting-started/using-unreal-engine.mdIntegrate the Discord Social SDK into Unreal Engine games.
  • [claimed-docs] https://docs.discord.com/developers/discord-social-sdk/getting-started.mdWith the Discord Social SDK, you can offer a seamless social experience for your players, allowing them to connect with their friends and communities on Discord without leaving your game.

Subscribe to events via webhooksweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdSend messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookWebhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookThey do not require a bot user or authentication to use.
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild

Agent-ready = 77.2 ÷ 130 × 100 = 59.4

API quality0.0/100×0.20 of the PA blend

The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.

Explore an interactive API reference with runnable examplesweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.
  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways:
  • [probe] https://docs.discord.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.discord.com/openapi.json, https://docs.discord.com/swagger.json, https://docs.discord.com/api/openapi.json, https://docs.discord.com/.well-known/openapi.json)

Download a machine-readable API spec (OpenAPI or equivalent)weight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://docs.discord.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.discord.com/openapi.json, https://docs.discord.com/swagger.json, https://docs.discord.com/api/openapi.json, https://docs.discord.com/.well-known/openapi.json)
  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.

Test against a sandbox environment without touching production dataweight 1

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Rely on versioned APIs with a documented deprecation policyweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.
  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild

API quality = 0.0 ÷ 60 × 100 = 0.0

Openness12.0/100×0.20 of the PA blend

Can you leave, inspect, or self-host — data export, open source, portability.

Do everything through the API that I can do in the UIweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/introBuild automated apps, commands, and integrations that run inside Discord servers.
  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookWebhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewSlash commands are the most common type of command and are accessed by typing `/` in the chat input, or by opening the command picker.
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild
  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.
  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdSend messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
  • [probe] https://docs.discord.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.discord.com/openapi.json, https://docs.discord.com/swagger.json, https://docs.discord.com/api/openapi.json, https://docs.discord.com/.well-known/openapi.json)

Export all of my data in open formats and leaveweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [community] https://news.ycombinator.com/item?id=46945663One day I came to discover that Discord had banned the server for allegedly violating something. I wish I had written down everyone's emails because I permanently lost contact with a bunch of friends instantly.
  • [community] https://news.ycombinator.com/item?id=29154216I think Discord UI/UX is beyond terrible and Discord is nothing more than a terrible walled garden where none of the content has any discoverability... every time I try to do anything in Discord, I can never intuit my way to it.
  • [claimed-docs] https://docs.discord.com/developers/referenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications.

Read the product's source under an open licenseweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Self-host the core productweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Openness = 6.0 ÷ 50 × 100 = 12.0

Built-in AI6.7/100×0.15 of the PA blend

Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.

Get AI-generated insights and suggestions from my data inside the productweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Set up automations that run autonomously in the backgroundweight 2

2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild, like when a channel is updated or a role is created.
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookWebhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdCI/CD pipelines posting build results or deployment notifications
  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdSend messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
  • [claimed-docs] https://docs.discord.com/developers/referenceAuthenticating with the Discord API can be done in one of two ways: 1. Using a bot token... 2. Using an OAuth2 bearer token

Delegate tasks to a built-in AI assistant inside the productweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Operate the product with natural-language commandsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewSlash commands are the most common type of command and are accessed by typing `/` in the chat input, or by opening the command picker.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewButtons are clickable components that can be customized with different styles, texts, and emoji.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewModals are single-user pop-up interfaces that allow apps to collect form-like data.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewApplication commands provide users a native way to invoke an app in Discord.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewApplication commands provide users a native way to invoke an app in Discord. They often map to an app’s core features or functionality.
  • [claimed-docs] https://docs.discord.com/developers/interactions/overviewInteractive features like commands and message components allows users to invoke an app natively within Discord.

Built-in AI = 6.0 ÷ 90 × 100 = 6.7

Automation14.4/100×0.15 of the PA blend

Depth of automation primitives — rules, scheduling, bulk operations, webhooks.

Perform bulk operations across many items at onceweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 4 (quality) × 0.6 (partial) = 7.2 of 30 max

  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild
  • [claimed-docs] https://docs.discord.com/developers/events/gatewayThe Gateway API lets apps open secure WebSocket connections with Discord to receive events about actions that take place in a server/guild, like when a channel is updated or a role is created.
  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdCI/CD pipelines posting build results or deployment notifications
  • [claimed-docs] https://docs.discord.com/developers/platform/webhooks.mdSend messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
  • [claimed-docs] https://docs.discord.com/developers/resources/webhookWebhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.

Schedule recurring jobs or workflowsweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Version, review, and roll back my automationsweight 1

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Automation = 7.2 ÷ 50 × 100 = 14.4