In short: Your mcfreehost Minecraft server also gets its own status page automatically — including a badge for your community's Discord server and an iframe widget for your own website. Whether and how visible any of it is stays your decision.
What Minecraft communities use the status page for
Many mcfreehost servers run a whitelist round for a fixed group of friends, while others run an open community server with its own Discord. Either way, the same question comes up before every login: is the server up right now? Instead of asking in the Discord chat every time, just link the status page — or embed it directly as a badge in the Discord server description or as a widget on the clan website. It costs nothing and runs entirely on our infrastructure.
A typical example: before a shared building session in the whitelist round, one glance at the status page or the badge in the Discord channel shows whether the server is already up — no more pinging around, no "is it up yet?" in chat. If you run an open community server instead, the page helps brand-new members before their very first join: they can see right away that the server is actively maintained before they even type the address into their client.
You decide what is visible
As with every server we host, visibility is a genuine three-way decision, not a simple on/off switch:
- Public — the status page is reachable and additionally listed.
- Unlisted — reachable via the link, but never surfaces on its own. Ideal for a private whitelist round meant only for your own group.
- Off — fully disabled; the badge and widget then stop returning real data too, since both require the same flag.
The status-page feature is enabled by default so your server has a reachable address right away. Whether it gets listed publicly is a choice you make on your first visit to the server panel via a dedicated decision card — there is no silent automation deciding for you. Changeable any time in the "Statuspage" tab.
Who is online: the player-name toggle
A dedicated switch (status_page_show_players, enabled by default) controls whether the currently active player names are shown at all — an important detail for many whitelist communities, since it lets everyone see who is playing at a glance. It affects exactly two places: the status page itself and the public JSON API further below. The badge and widget, however, only ever show the raw player count, never names — regardless of this switch.
Badge: your server status as an image
For your Discord server description, a forum profile or a GitHub README, there is a live badge as an SVG image. Replace dein-server with your own slug:
<img src="https://mcfreehost.com/badge/dein-server" alt="Server Status">
[img]https://mcfreehost.com/badge/dein-server[/img]
iframe widget: a live card for your community website
For your own clan or community website, there is a full status card as an iframe, at its original 340×120 pixel size:
<iframe src="https://mcfreehost.com/embed/dein-server" width="340" height="120" loading="lazy" style="border:0;border-radius:8px"></iframe>
The widget shows live status, player count and the connection address — enough to tell at a glance whether joining is worth it right now.
For tinkerers: the public JSON API
Building your own Discord bot that posts the server status automatically? The public, unauthenticated JSON API returns current players at /api/public/status/{slug}/players and history at /api/public/status/{slug}/history. The limit is 60 requests per minute — more than enough for a bot that refreshes every few minutes. A once-a-second poller would not get fresher data anyway.
How to unlock it
Open your server in the customer area, switch to the "Statuspage" tab, choose your slug and copy the badge or widget code with one click on the copy button. No extra tool, no separate account.
To wrap up
A shared status page costs nothing but a copy-paste — but it saves your community every "is the server up?" question in Discord and makes your server visible to everyone who might want to join in.