# Gerbsoda402 Minecraft Server Status API

> Gerbsoda402 Minecraft Server Status API is a paid API for AI agents from api.gerbsoda402.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns live status information for a Minecraft server by hostname or IP, including online state, player counts, MOTD, version, and latency.

## Facts

- Endpoint: GET https://api.gerbsoda402.xyz/api/mcstatus
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gerbsoda402-minecraft-server-status-api-dbf91d91
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v0jT1jdTOpc4Zt5HbfWYd

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 gerbsoda402-minecraft-server-status-api-dbf91d91
```

Example prompt: Can you check if the Minecraft server at mc.hypixel.net is online right now, and tell me how many players are currently connected?

## When to prefer this

Choose this endpoint when you need real-time Minecraft server status data — including player counts, MOTD, version, and latency — via a simple GET call with per-query micropayment billing. Ideal for agents building Minecraft dashboards, monitoring bots, or any workflow that needs live server health checks without managing your own scanner infrastructure.

## Known failure modes

- Server unreachable or offline — returns online: false with no player/version data
- Invalid or non-existent hostname — DNS resolution failure
- Port not open or firewall blocking — connection timeout
- Non-Minecraft service at address — protocol mismatch error
- Missing required 'host' query parameter — request validation error

## How this service works

Paid endpoints served over x402: live weather and Minecraft server status.

## Output

A JSON object containing: host (string), online (boolean), motd (server message of the day), version (supported Minecraft version string), players_online (integer), players_max (integer), and latency_ms (round-trip ping in milliseconds).

## 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": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "host"
     ],
     "properties": {
      "host": {
       "type": "string",
       "description": "Server hostname or IP address"
      },
      "port": {
       "type": "integer",
       "description": "Server port (default 25565)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "host": "mc.hypixel.net",
  "motd": "Hypixel Network",
  "online": true,
  "version": "1.8-1.21.x",
  "latency_ms": 38,
  "players_max": 200000,
  "players_online": 42318
 }
}
```

## More

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