# Minecraft Server Status API (Lodestone)

> Minecraft Server Status API (Lodestone) is a paid API for AI agents from mcapi.jackiscool.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Returns live status information for any Minecraft server, including online/offline state, MOTD, player counts, latency, and version.

## Facts

- Endpoint: GET https://mcapi.jackiscool.com/server-status?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minecraft-server-status-api-lodestone-c01f8eec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z8sgfTwK-e9zPWWA6S_YR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability minecraft-server-status-api-lodestone-c01f8eec
```

Example prompt: Is mc.hypixel.net currently online, and how many players are on it right now?

## When to prefer this

Use this endpoint when you need real-time Minecraft server status (online state, player counts, MOTD, version, latency) for any Java Edition server by hostname. Prefer this over manual pinging or scraping server listing sites when you need programmatic, low-latency, pay-per-call access with no account setup.

## Known failure modes

- Server unreachable or offline — returns online: false
- Invalid or unresolvable host — likely returns error or empty response
- Non-standard port not accessible — query times out or returns offline
- SRV record lookup failure for port-less requests — may result in incorrect port resolution

## How this service works

Modrinth mod compatibility checks for agents and modpack tools. 0.01 USDC per call via x402, no signup.

## Output

A JSON object with: online status (boolean), MOTD string, server version string, latency in milliseconds, current player count, and maximum player capacity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "host"
     ],
     "properties": {
      "host": {
       "type": "string",
       "description": "Server address, e.g. mc.hypixel.net"
      },
      "port": {
       "type": "integer",
       "description": "Port (default 25565, SRV record used if omitted)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "motd": "Hypixel Network",
  "online": true,
  "version": "Requires MC 1.8 / 1.21",
  "latency_ms": 40,
  "players_max": 200000,
  "players_online": 30000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minecraft-server-status-api-lodestone-c01f8eec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcapi.jackiscool.com](https://www.zero.xyz/host/mcapi.jackiscool.com/llms.txt)
