Game

Query MC Server

0calls

1 credits / call

Want to check how many people are online before joining a server? Or verify if the server is running? This endpoint is perfect for that!

Overview

By providing a server address (domain or IP), you can get the real-time status of a Minecraft Java Edition server. Returned information includes whether the server is online, current player count, max player count, server version, MOTD (Message of the Day) and server icon.

If the server returns a list of currently online players, the response will include an online_players field. This field may be omitted, and some servers may return incomplete lists.

Query parameters

server

stringrequired

Minecraft server address, can be a domain (e.g., hypixel.net) or in IP:port format (e.g., mc.example.com:25565). If port is omitted, it will default to 25565.

Name	Type	Attributes	Description
`server`	string	required	Minecraft server address, can be a domain (e.g., `hypixel.net`) or in `IP:port` format (e.g., `mc.example.com:25565`). If port is omitted, it will default to `25565`.

Response

200 / OK

Query successful! Returns detailed server status information.

JSON

400 / Bad Request

Request failed. Please check if you provided the server parameter.

JSON

404 / Not Found

Server not found. This may mean the server address you provided cannot be resolved, or the server is currently offline.

JSON

502 / Bad Gateway

Query failed. A network or protocol error occurred while attempting to connect and retrieve server information.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/game/minecraft/serverstatus?server=play.minedhype.com'

Frequently asked questions

Are there any special restrictions for the Query MC Server API?

Query MC Server follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

PreviousQuery MC Former Names

NextQuery MC Player