ModsFinder

MCRestAPI

by Natxo

MCRestAPI gives a dedicated Fabric server a REST interface for reading status, managing players and running commands over HTTP.

FabricServer-side onlyMIT LicenseOpen source1.21.11 – 26.1.2

What it does

The API reports server monitoring figures such as TPS, MSPT, memory, CPU usage, player count and server properties. Player data covers health, food, position, dimension, ping, gamemode, operator status and skin head URL. World figures cover the world's seed, clock, climate, difficulty setting, number of entities, loaded chunks and statistics for each dimension. Remote command execution is available through the API.

A Server-Sent Events stream at api/events/stream sends chat, joins, leaves, deaths and other game messages in standard SSE format, with a keepalive ping every 30 seconds. A bundled single-page admin dashboard covers monitoring and management, and a Swagger UI with an OpenAPI 3.1.0 specification documents the endpoints at api/docs. The mod has zero external dependencies beyond Fabric API. It is server-side only, released under the MIT License, and is open source. Files are published for 26.1.2 and three earlier builds, covering 1.21.11 – 26.1.2.

Key features

  1. Live server monitoring

    Figures include TPS, MSPT, memory, CPU usage and player count, read through the REST endpoints.

  2. Multi-key authentication

    API keys carry granular permissions, and wildcard permissions cover the data endpoints. Key hashes are stored with PBKDF2-SHA256.

  3. Admin dashboard

    A built-in web dashboard handles monitoring and management from a browser, with the master key granting access to admin endpoints.

  4. Event stream

    The SSE stream delivers chat, joins, leaves, deaths and other game messages as they happen.

Compatibility

Latest build for each game version and loader.

26.1.22.0.0+26.1.2
26.1.12.0.0+26.1.2
26.12.0.0+26.1.2
1.21.111.2.0
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

How it compares

Full comparison

TPSnitch is server-side only, open source under the Apache License 2.0, and runs on Fabric for 1.21 – 26.2. TPSChecker is also server-side only and Fabric-only, but it targets 1.21.5 alone and is not open source under the MIT License. Dash - Dashboard covers Fabric and NeoForge for 1.21 – 26.2 under the BSD 3-Clause License, and it is not open source. MCRestAPI is server-side only and open source under the MIT License, with builds for 1.21.11 – 26.1.2.

ModLoadersGame versionsEnvironmentUpdated
MCRestAPIFabric1.21.11 – 26.1.2Server-side only2026-06-12
TPSnitchFabric1.21 – 26.2Server-side only2026-07-09
TPSCheckerFabric1.21.5Server-side only2025-06-23
Dash - DashboardFabric and NeoForge1.21 – 26.2Server-side only2026-09-03

Questions

Does MCRestAPI need Fabric API?

Yes. Fabric API is the only required dependency, and the mod has no other external dependencies.

Does a player need the mod to join the server?

No. Players join without it, since only the server has to run the mod.

Should authentication stay enabled when a reverse proxy is used?

The mod warns at startup when the bind address is not loopback. If a proxy already handles auth, the auth.enabled setting can be set to false, but then the proxy must be the only way in.

Where are the endpoint details documented?

Request and response examples for every endpoint are listed in the Swagger UI at api/docs.

In the catalog

MCRestAPI is one of 8,499 Technology mods on ModsFinder, and one of 4,201 Technology mods for Fabric. 15,189 mods support Minecraft 26.1.2.

More from Natxo

All projects

Similar mods

What the author says

Each release on Modrinth is tagged with its supported Minecraft version — install the one matching your server. The configuration file is located at config/mcrestapi.json and is generated automatically on first launch.
Natxo, on the Modrinth page

Official listing

Owner
Natxo
Published
2026-03-06
Updated on Modrinth
2026-06-12
Facts verified
2026-10-15

Tags