Skip to main content

NeatQueue API

Welcome to the NeatQueue API documentation. The NeatQueue API allows you to interact with your queues, retrieve statistics, and manage your server programmatically.

Base URL​

https://api.neatqueue.com/

Authentication​

To use the NeatQueue API, you'll need an API token. Generate one using the /webhooks generatetoken command in your Discord server.

Include your API token in the Authorization header of your requests:

Authorization: Bearer YOUR_API_TOKEN

Getting Started​

  1. Generate an API token using /webhooks generatetoken in Discord
  2. Make a test request to verify your token
  3. Explore the API endpoints in this documentation to see what's available

Example Request​

curl -X GET "https://api.neatqueue.com/api/v1/stats" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Rate Limiting​

The NeatQueue API implements rate limiting to ensure fair usage:

  • Default: 60 requests per minute per token
  • Premium: Higher rate limits available

Available Endpoints​

The API provides endpoints for:

  • Bot Stats - Get overall bot statistics
  • Queues - List active queues and players in queue
  • Player Stats - Retrieve player statistics and MMR
  • Matches - Get match history and active matches
  • Commands - Execute queue management commands via API

Browse the sidebar to explore all available endpoints.

MCP (Model Context Protocol)​

The whole API is also available as an MCP server, so AI assistants and agents can call it as tools. Every endpoint documented here is a tool named after the endpoint (for example playerstats, leaderboard_v2, add_stats), with the same parameters and the same permission checks as the REST call.

https://api.neatqueue.com/mcp

Use the streamable HTTP transport and send your API token in the Authorization header, exactly as for REST. Example configuration for a client that supports remote MCP servers:

{
  "mcpServers": {
    "neatqueue": {
      "url": "https://api.neatqueue.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

Support​

If you encounter issues with the API:

Swagger​

If you prefer to use Swagger, check out https://api.neatqueue.com/docs

OpenAPI Specification​

The API specification is automatically fetched from https://api.neatqueue.com/docs.json and is always up-to-date with the latest API changes.