mcsrvstat API

Free Minecraft server status API with no key: ping any Java or Bedrock server for players online, MOTD, version, icon and mods. Tested curl example.

No API key requiredCORS enabledHTTPSFree tier

Endpoint tested and returned HTTP 200 on 20 Aug 2026

What is the mcsrvstat API?

mcsrvstat is a free, key-free API that pings any Minecraft server — Java or Bedrock — and returns whether it is online, current and maximum player counts, MOTD, server version, icon and installed plugins or mods.

Querying a Minecraft server directly requires implementing its custom TCP handshake protocol. This API does that for you and returns clean JSON, which turns a fiddly networking task into a single HTTP request.

Responses are cached for around a minute, which is deliberate — it protects target servers from being hammered by status widgets. Do not expect second-by-second player counts, and do not try to poll around it.

Quick facts

Base URL: https://api.mcsrvstat.us
Authentication: No API key required.
Rate limit: Responses are cached roughly one minute per server; polling faster returns the cached value.
Pricing: Free.
CORS: Enabled — callable directly from browser JavaScript
Official docs: Read the docs

How to use the mcsrvstat API

Every request below was executed against the live API on 20 Aug 2026, and the response shown is the real body it returned — not an illustration.

1. Check a Minecraft server's status

GET https://api.mcsrvstat.us/3/hypixel.net

curl

curl 'https://api.mcsrvstat.us/3/hypixel.net'

JavaScript (fetch)

const res = await fetch("https://api.mcsrvstat.us/3/hypixel.net");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://api.mcsrvstat.us/3/hypixel.net", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200 (truncated)

{
  "ip": "172.65.197.160",
  "port": 25565,
  "debug": {
    "ping": true,
    "query": false,
    "bedrock": false,
    "srv": false,
    "querymismatch": false,
    "ipinsrv": false,
    "cnameinsrv": false,
    "animatedmotd": false,
    "cachehit": true,
    "cachetime": 1787208223,
    "cacheexpire": 1787208523,
    "apiversion": 3,
    "dns": {
      "a": [
        {
          "name": "mc.hypixel.net",
          "type": "A",
          "address": "172.65.197.160"
        }
      ]
    },
    "error": {
      "query": "Failed to read from socket."
    }
  },
  "motd": {
    "raw": [
      "§f                 §aHypixel Network §c[1.8/26.2]",
      "§f   §6§lSB 0.27 TORRHUS & SAFARI §7| §e§lSUMMER EVENT"
    ],
    "clean": [
      "                 Hypixel Network [1.8/26.2]",
      "   SB 0.27 TORRHUS &amp; SAFARI | SUMMER EVENT"
    ],
    "html": [
      "<span style=\"color: #FFFFFF;\">                 </span><span style=\"color: #55FF55;\">Hypixel Network </span><span style=\"color: #FF5555;\">[1.8/26.2]</span>",
      "<span style=\"color: #FFFFFF;\">   </span><span style=\"color: #FFAA00;\"><span style=\"font-weight: bold;\">SB 0.27 TORRHUS &amp; SAFARI </span></span><span style=\"color: #AAAAAA;\">| </span><span style=\"color: #FFFF55;\"><span style=\"font-weight: bold;\">SUMMER EVENT</span></span>"
    ]
  },
  "players": {
    "online": 17852,
    "max": 200000
  },
  "version": "Requires MC 1.8 / 1.21",
  "online": true,
  "protocol": {
    "version": 47,
    "name": "1.8.9"
  },
  "hostname": "mc.hypixel.net",
  "icon": "data:image/png;base64,iVBORw0KGgoAAAA

Parameters

Parameter	Type	Required	Description
`3/<address>`	path	Required	API version 3 and the server address. `3/hypixel.net`
`bedrock/3/<address>`	path	Optional	Bedrock edition servers. `bedrock/3/example.com`
`icon/<address>`	path	Optional	The server's icon as a PNG. `icon/hypixel.net`

Response fields

onlineboolean: Whether the server responded — check this first.
ip / portstring|integer: Resolved address and port.
players.online / players.maxinteger: Current and maximum player counts.
motd.cleanarray: Message of the day with colour codes stripped.
versionstring: Server version string.
protocolobject: Protocol version and name.
plugins / modsarray: Installed plugins or mods, when the server reports them.

What you can build with the mcsrvstat API

Show live server status and player count on a community site
Build a Discord bot that reports whether a server is up
Monitor server availability and alert on downtime
Display MOTD and server icon in a launcher

Common errors and how to fix them

online: false

The server is down, or the address is wrong.

Fix: Check `online` before reading any other field — the rest will be absent.

MOTD contains colour codes

Minecraft MOTDs use section-sign formatting.

Fix: Use motd.clean, which has the codes stripped, rather than motd.raw.

Player count seems stale

Responses are cached about a minute.

Fix: That is deliberate to protect target servers; polling faster returns the same cached value.

mcsrvstat API — frequently asked questions

Is the Minecraft server status API free?

Yes, free with no API key. Responses are cached roughly a minute per server to protect the servers being queried.

Does it work with Bedrock servers?

Yes, use the /bedrock/3/ path prefix. Java servers use /3/ directly.

Why not query the server directly?

Minecraft uses a custom TCP handshake protocol rather than HTTP. This API implements that for you and returns JSON.

Why is the MOTD full of strange characters?

Minecraft MOTDs embed section-sign colour codes. Use motd.clean, which strips them, rather than motd.raw.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Alternatives to mcsrvstat API

If mcsrvstat does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

API	What it does	Auth	CORS	Last verified
PokéAPI	Free Pokémon API with no key: stats, types, abilities, moves, evolutions and sprites for 1,000+ species. The most popular API for learning REST. Tested example.	No key	Yes	19 Aug 2026
Rick and Morty API	Free Rick and Morty API with no key: 800+ characters, episodes and locations with images, filtering and pagination. REST and GraphQL. Tested example.	No key	Yes	19 Aug 2026
Jikan (MyAnimeList)	Free unofficial MyAnimeList API with no key: anime and manga data, scores, characters, staff and seasonal listings. Tested curl example and live JSON.	No key	Yes	19 Aug 2026
Deck of Cards	Free playing card API with no key: shuffle decks, draw cards, manage piles and get card images. Stateful deck ids. Tested curl example and live JSON.	No key	Yes	19 Aug 2026
Minecraft ServerHub	Free Minecraft server ping API with no key: online state, player counts, version, MOTD and the server icon as a data URI, plus SVG and PNG status badges. Live example.	No key	No	21 Aug 2026
MMOBomb	Free MMO games API with no key: free-to-play MMOs and online games with genres, platforms, screenshots, release dates and giveaway data. Tested example.	No key	Yes	20 Aug 2026

All Game & Anime APIs

mcsrvstat is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 20 Aug 2026; always check the official documentation before relying on this API in production, as terms and limits can change.