MCAPI - Minecraft Client API

MCAPI is a Fabric client-side Minecraft mod that provides a simple and powerful HTTP JSON API for external applications.

The mod allows programs, bots, dashboards, websites, and scripts to access live information from your Minecraft client in real time. MCAPI works as a bridge between Minecraft and external software, making it easy to create integrations, monitoring tools, overlays, and custom applications.

Features

Player Information

MCAPI provides detailed information about the current player:

• Player name and UUID
• Health
• Hunger and saturation
• Gamemode
• Position
• Rotation (Yaw/Pitch)
• Movement speed
• Sprinting state
• Sneaking state
• Flying state
• Inventory and equipped items

World & Server Information

Access information about the current world and server:

• Current dimension
• Difficulty
• Server IP
• Ping
• Online player count
• Chunk position
• World time
• Biome
• Block light level
• Sky light level

Client Information

Get information about the Minecraft client:

• Current FPS
• Client TPS estimation
• Installed Fabric mods

API

MCAPI provides simple HTTP JSON endpoints that can be used by external applications.

Available endpoints:

All responses are returned in JSON format for easy integration with many programming languages.

Security

MCAPI includes API key authentication to protect your data.

Protected endpoints require a valid API key using the X-API-Key header.

Example: X-API-Key: your-secret-key

Use Cases

MCAPI can be used for:

• Discord bots
• Minecraft dashboards
• Stream overlays
• External monitoring tools
• Custom scripts
• Personal Minecraft utilities
• Integration with other applications

Requirements

• Minecraft 1.21.x
• Fabric Loader
• Fabric API
• Java 21

About

MCAPI is designed to be lightweight, fast, and developer-friendly. It does not modify gameplay or automate actions. It only provides Minecraft client data to external applications through a secure HTTP API.