# Mcsrvstat — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Check whether Minecraft servers are online and retrieve live server details including player counts, server icons, MOTD, and version metadata for both Java and Bedrock Edition servers.

**Category:** Developer Tools | **Website:** [mcsrvstat.us/](https://mcsrvstat.us/) | **Docs:** [parse.bot/marketplace/20a8fb49-db90-4724-9ce7-764d608cc862/mcsrvstat-us-api](https://parse.bot/marketplace/20a8fb49-db90-4724-9ce7-764d608cc862/mcsrvstat-us-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/mcsrvstat/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get bedrock server status

Retrieve real-time status of a Minecraft Bedrock Edition server. Returns server data including online status, player count, gamemode, server ID, and MOTD. The response always includes the 'online' boolean; when offline, most other fields are absent.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Server hostname or IP address (e.g., 'play.histeria.fr'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mcsrvstat/get-bedrock-server-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>"}'
```

### Get java server status

Retrieve real-time status of a Minecraft Java Edition server (1.7+). Returns comprehensive server data including online status, player count, MOTD, version, icon, protocol, and debug/DNS information. The response always includes the 'online' boolean; when offline, most other fields are absent.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Server hostname or IP address (e.g., 'hypixel.net', 'mc.mineplex.com'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mcsrvstat/get-java-server-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>"}'
```

### Get server icon

Retrieve a Minecraft server's favicon/icon as a base64-encoded data URI string. Works for both Java and Bedrock editions, though Bedrock servers rarely have icons. Returns null for the icon field when the server has no custom icon set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Server hostname or IP address. |
| `is_bedrock` | boolean | No | Set to true to query a Bedrock Edition server instead of Java Edition. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mcsrvstat/get-server-icon \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","is_bedrock":"<boolean>"}'
```

### Is server online

Quick check if a Minecraft server is online with player counts. Works for both Java and Bedrock editions. Returns only online status and player counts, not full server details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | Yes | Server hostname or IP address. |
| `is_bedrock` | boolean | No | Set to true to query a Bedrock Edition server instead of Java Edition. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mcsrvstat/is-server-online \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","is_bedrock":"<boolean>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.