01. Introduction
The McServ API allows admins to check if a user has voted during the current calendar day. Votes are reset daily at 00:00 (UTC).
02. Why use the API?
LOSS-PROOF RELIABILITY
Unlike Votifier notifications, which can be missed if your server is down, the API allows for on-demand verification upon login.
SHOPS & WEBSTORES
Check votes on your web store to apply discounts or unlock items without the player being in-game.
STATS & DASHBOARDS
Display a dynamic reminder on your site or launcher to show players if they've supported the server today.
03. Retrieving Your Slug
The slug is the permanent text identifier in your server's URL. It is more stable than a numeric ID.
mcserv.org/servers/slug_de_votre_serveur→ Identifier to extract from your public McServ URL.
04. Access Points
GET
slug/IPResponse text/plain : 1 (voted) or 0 (no vote).
GET
slug/IP/jsonDetailed JSON response including timestamp and the midnight reset.
RESPONSE_PREVIEW:
{
"vote": "1",
"voted_at": "2026-02-05T14:20:01Z",
"reset": true,
"next_in": 34799
}