# MCStat.org Full AI Context

This file concatenates the primary AI-readable Markdown pages for MCStat.org. It is designed for LLM context loading, retrieval systems, and AI coding agents.

Canonical domain: https://mcstat.org
Generated locale: en

---

# Minecraft Server List, Player Tracker & Live Stats | MCStat.org

Discover Minecraft servers and players with live stats, vote rankings, uptime tracking, and player profiles. Browse the top Minecraft server directory on MCStat.

Canonical HTML: https://mcstat.org
Markdown URL: https://mcstat.org/ai/home.md
Locale: en (English)
Priority: core

## Audience

Minecraft players, server owners, AI search systems, and agents looking for an overview of MCStat.org.

## Page Contents

- Live platform totals
- Top public Minecraft servers
- Server discovery entry points
- Links into the public directory

## User And Agent Actions

- Discover active servers
- Open the full server directory
- Add a server through the owner dashboard

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Main Explanatory Content

Context label: Minecraft server intelligence

### What is MCStat and how does it help Minecraft players?

What is MCStat? MCStat is a live Minecraft discovery layer for players who need more than a stale server list. It combines public server pages, real-time player counts, vote momentum, uptime history, version details, tags, country signals, player profiles, and community pages so visitors can compare servers before joining. Players use it to find active Java and crossplay communities, copy server IPs quickly, check reliability, and understand whether a server matches their preferred mode. Server owners use MCStat to make their public listing more discoverable with useful context instead of a bare IP address. Because the pages expose clear headings, structured data, live stats, and canonical URLs, MCStat also gives search engines and AI answer systems a sourceable summary of Minecraft server quality, popularity, reliability, and recent activity. The data refreshes continually as public server and profile signals change.

Freshness note: Updated continuously from public server pings, vote activity, and profile signals.

## Home Insight Cards

### How do I find a good server quickly?

Start with live player counts, version compatibility, tags, and uptime trends. MCStat puts those signals on one page so you can narrow options before you copy an IP.

### Why are MCStat rankings useful?

Rankings reflect real activity signals such as player momentum, votes, freshness, and reliability. That gives players a better shortlist than static directories with outdated entries.

### How does MCStat help server owners?

Public server pages, vote visibility, and historical performance data give owners a stronger profile in search while helping players understand what makes a server worth joining.

## FAQ

### HOW DO I FIND THE BEST MINECRAFT SERVER ON MCSTAT?

Rankings are shaped by live player counts, uptime rates, and trust signals. Start with the top entries and try 2–3 servers to find the best fit for your playstyle.

### HOW DO I JOIN A MINECRAFT SERVER?

Copy the server IP from the listing, open Minecraft, click Multiplayer → Add Server, paste the IP, and hit Join Server.

### WHAT ADVANTAGES DOES MCSTAT OFFER PLAYERS?

MCStat shows real-time player counts, uptime history, version info, tags, and reviews — all in one place — so you can make an informed choice before joining.

### HOW CAN SERVER OWNERS BENEFIT FROM MCSTAT?

Adding your server to MCStat gets it in front of thousands of active Minecraft players every day. Vote counts and uptime scores help you rank higher over time.

### DO I NEED A PREMIUM MINECRAFT ACCOUNT TO JOIN THESE SERVERS?

It depends on the server. Most servers listed here support both premium (Java Edition) and cracked clients, but always check the server description for requirements.

### HOW DO I TELL IF A SERVER SUPPORTS BEDROCK OR JAVA?

Check the server's tags or description — servers that support Bedrock Edition will usually say so explicitly. Java-only servers will not mention Bedrock.

### WHAT SHOULD I DO IF A SERVER IS FULL?

Try again later, or look for a server in the same category with fewer players relative to its max capacity. Some servers also have VIP queues.

### WHY DOES A SERVER SHOW AS ONLINE BUT I CANNOT JOIN?

The server may be whitelisted, have an active maintenance window, or require a specific Minecraft version. Check the server page for version and whitelist info.

### ARE THESE SERVERS SAFE TO JOIN?

MCStat lists servers but does not operate them. Always use your best judgment — avoid sharing personal information in-game and be cautious on unfamiliar servers.

### HOW DO I PLAY ON THE SAME SERVER AS MY FRIENDS?

Share the server IP with your friends so they can add it in their Minecraft client. You can copy the IP directly from any server listing on MCStat.

### DO SERVERS RESET THEIR WORLDS?

It varies by server. Survival and SMP servers may reset seasonally, while minigame or lobby servers usually do not. Check the server's description or Discord for reset info.

### WHAT IS THE FASTEST WAY TO FIND A SERVER I WILL ACTUALLY LIKE?

Use the tag and game mode filters on the Servers page. Filter by your preferred mode (Survival, Skyblock, Prison, etc.) and sort by current players to find active communities quickly.

---

# Minecraft Server List with Live Stats & Rankings | MCStat.org

Explore Minecraft servers with live player counts, vote rankings, uptime history, server tags, versions, and detailed server profiles for Java and crossplay communities.

Canonical HTML: https://mcstat.org/servers
Markdown URL: https://mcstat.org/ai/servers.md
Locale: en (English)
Priority: core

## Audience

Agents and users comparing Minecraft servers by activity, uptime, tags, game mode, votes, country, and version.

## Page Contents

- Paginated server directory
- Search and filter controls
- Server cards with live player counts and public metadata

## User And Agent Actions

- Search servers
- Filter by tags, country, version, mode, and activity
- Open server detail pages

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Minecraft Player Profiles & Stats Tracker | MCStat.org

Search Minecraft players, view detailed profiles, track playtime, review server history, and explore activity across public Minecraft communities on MCStat.org.

Canonical HTML: https://mcstat.org/players
Markdown URL: https://mcstat.org/ai/players.md
Locale: en (English)
Priority: core

## Audience

Agents and users looking for public Minecraft player profiles and activity signals.

## Page Contents

- Player directory
- Public profile links
- Activity and ranking signals where available

## User And Agent Actions

- Search Minecraft players
- Open player profile pages
- Compare public activity signals

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Minecraft Leaderboards — Player & Server Rankings | MCStat.org

Compare Minecraft leaderboards ranked by player sessions and server diversity. Discover the most active players and the highest-ranked Minecraft servers on MCStat.

Canonical HTML: https://mcstat.org/leaderboards
Markdown URL: https://mcstat.org/ai/leaderboards.md
Locale: en (English)
Priority: important

## Audience

Agents summarizing public Minecraft player rankings and leaderboard context.

## Page Contents

- Leaderboard metric filters
- Ranking tables
- Tier and period context

## User And Agent Actions

- Browse rankings
- Filter leaderboard metrics
- Use rankings as aggregate public context

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Live Minecraft Server Stats & Player Activity | MCStat.org

Track live Minecraft server statistics, online player activity, trending server movement, and real-time network changes across the MCStat server directory.

Canonical HTML: https://mcstat.org/live
Markdown URL: https://mcstat.org/ai/live.md
Locale: en (English)
Priority: core

## Audience

Agents that need current aggregate Minecraft server and player activity on MCStat.org.

## Page Contents

- Live global totals
- Top active servers
- Recent public activity
- Regional and country distribution signals

## User And Agent Actions

- Read current totals
- Identify trending servers
- Summarize aggregate live activity

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Minecraft Forum — Servers, Guides & Community | MCStat.org

Join Minecraft forum discussions about servers, plugins, player help, updates, and community guides. Connect with players and the MCStat Minecraft community.

Canonical HTML: https://mcstat.org/forum
Markdown URL: https://mcstat.org/ai/forum.md
Locale: en (English)
Priority: important

## Audience

Agents looking for public community discussions, guides, support topics, and server conversations.

## Page Contents

- Forum categories
- Public topic lists
- Discussion metadata

## User And Agent Actions

- Browse public discussions
- Open topic pages
- Find community context

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Forum Overview

- Browse discussions by category
- Forum Stats
- Trending
- Join the Discussion
- Sign up to create topics and participate in discussions
- Filter

## Topic Detail UX

### Reply Form

- Post a Reply
- Write your reply here...
- Post Reply
- This topic is locked. You cannot post a reply.
- You must be logged in to reply.
- Login to Reply

### Report Flow

- Report Post
- Tell us why you are reporting this post from {author}.
- Explain the issue briefly. Include spam, abuse, harassment, or rule violations if relevant...
- Please enter at least 10 characters.
- Cancel
- Submit Report

## Create Topic Flow

Create New Topic

Share your thoughts with the community

- Topic Details
- Please provide a clear title and content for your topic
Fields:
- Category
- Title
- Tags (comma separated)
- Content
Hints:
- characters
- Use commas to separate tags
- Paste images directly into the editor.

---

# Minecraft Skins — Browse, Create & Share | MCStat.org

Browse, like and download Minecraft skins created by the MCStat community. Open the in-browser pixel editor to design and publish your own.

Canonical HTML: https://mcstat.org/skins
Markdown URL: https://mcstat.org/ai/skins.md
Locale: en (English)
Priority: important

## Audience

Agents and users browsing community-created Minecraft skins and capes.

## Page Contents

- Skin gallery
- Cape gallery links
- Creator metadata
- Download and detail pages where public

## User And Agent Actions

- Browse skins
- Open skin detail pages
- Create skins and capes through browser editors

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Minecraft Capes — Browse, Create & Share | MCStat.org

Explore and download custom Minecraft capes made by the MCStat community. Design your own cape with the in-browser pixel editor and publish it for free.

Canonical HTML: https://mcstat.org/skins/capes
Markdown URL: https://mcstat.org/ai/capes.md
Locale: en (English)
Priority: important

## Audience

Agents and users browsing community-created Minecraft capes.

## Page Contents

- Cape gallery
- Creator metadata
- Public detail pages
- Download context where public

## User And Agent Actions

- Browse capes
- Open cape detail pages
- Create capes through the browser editor

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Minecraft Skins — Browse, Create & Share | MCStat.org

Browse, like and download Minecraft skins created by the MCStat community. Open the in-browser pixel editor to design and publish your own.

Canonical HTML: https://mcstat.org/skins/create
Markdown URL: https://mcstat.org/ai/skin-studio.md
Locale: en (English)
Priority: supporting

## Audience

Users creating Minecraft skins in the browser.

## Page Contents

- Pixel editor interface
- 3D preview context
- Publishing workflow for logged-in users

## User And Agent Actions

- Design a skin
- Preview the model
- Publish a public skin

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# Minecraft Capes — Browse, Create & Share | MCStat.org

Explore and download custom Minecraft capes made by the MCStat community. Design your own cape with the in-browser pixel editor and publish it for free.

Canonical HTML: https://mcstat.org/skins/capes/create
Markdown URL: https://mcstat.org/ai/cape-studio.md
Locale: en (English)
Priority: supporting

## Audience

Users creating Minecraft capes in the browser.

## Page Contents

- Cape editor interface
- 3D preview context
- Publishing workflow for logged-in users

## User And Agent Actions

- Design a cape
- Preview the cape
- Publish a public cape

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

# MCStat API Docs | Minecraft Server & Player Data

Use the MCStat API to access Minecraft server lists, player profiles, live statistics, votes, and rankings. Build powerful apps, bots, dashboards, and server tools.

Canonical HTML: https://mcstat.org/api-docs
Markdown URL: https://mcstat.org/api-docs.md
Base URL: https://mcstat.org/api/v1

## Authentication

Public read endpoints can be explored from the MCStat.org API Docs playground after Cloudflare Turnstile human verification. Production integrations should use an API key where the docs require or recommend authentication.

Use the `X-API-Key` header for authenticated integrations.

## API Playground

The browser playground proxies requests through `/api/v1/api-docs/test`, validates Cloudflare Turnstile, allows only documented GET endpoints, and applies IP-based rate limiting.

## Endpoint Catalog

### Server endpoints

Browse, filter and inspect Minecraft servers tracked by mcstat.org.

#### GET /api/v1/servers

Title: List servers
Description: Paginated list of public servers with rich filters.

Parameters:
- `page` (integer, optional): Page number, starting at 1. Default: `1`.
- `limit` (integer, optional): Items per page. Default: `24`.
- `sort` (string, optional): Sort order. Default: `hot`.
- `search` (string, optional): Free-text query.
- `country` (string, optional): ISO country name filter.
- `version` (string, optional): Minecraft version filter.
- `tag` (string, optional): Filter by tag.
- `mode` (string, optional): Game-mode filter.
- `minPlayers` (integer, optional): Minimum current player count.
- `maxPlayers` (integer, optional): Maximum current player count.
- `minUptime` (number, optional): Minimum uptime percentage.
- `minVotes` (integer, optional): Minimum total vote count.
- `minRating` (number, optional): Minimum rating (1–5).
- `onlineOnly` (boolean, optional): Only include servers reporting online.

Example response:

```json
{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "cl0...",
        "slug": "hypixel-net",
        "name": "Hypixel",
        "ip": "mc.hypixel.net",
        "currentPlayers": 48230,
        "maxPlayers": 200000,
        "isOnline": true,
        "country": "United States",
        "version": "1.20.4",
        "uptime": 99.8,
        "totalVotes": 12345,
        "avgRating": 4.6
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
```

#### GET /api/v1/servers/{slug}

Title: Server detail
Description: Full server profile: stats history, uptime, vote chart, ranks.

Parameters:
- `slug` (string, required): Server slug (from /servers list).
- `period` (string, optional): Time window: 24h, 7d, 30d, 90d, all-time. Default: `24h`.

Example response:

```json
{
  "success": true,
  "data": {
    "server": {
      "id": "cl0...",
      "slug": "hypixel-net",
      "name": "Hypixel",
      "ip": "mc.hypixel.net",
      "icon": "https://mcstat.org/images/server-icon/cl0...png",
      "banner": "https://mcstat.org/media/banners/cl0...webp",
      "currentPlayers": 48230,
      "maxPlayers": 200000,
      "isOnline": true,
      "country": "United States",
      "version": "1.20.4",
      "uptime": 99.8,
      "latestStats": {
        "onlinePlayers": 48230,
        "timestamp": "2026-05-24T22:00:00Z"
      },
      "statsHistory": [
        {
          "timestamp": "...",
          "onlinePlayers": 47000
        }
      ],
      "periodStats": {
        "24h": {
          "avgPlayers": 46500,
          "peakPlayers": 49100,
          "uptimePct": 99.95
        }
      },
      "voteStats": {
        "total": 12345,
        "last24h": 412,
        "last7d": 2890
      },
      "dailyVotes": [
        {
          "date": "2026-05-23",
          "count": 405
        }
      ]
    }
  }
}
```

#### GET /api/v1/servers/{slug}/voters

Title: Server voters
Description: Recent voters (authenticated and anonymous) for the given server.

Parameters:
- `slug` (string, required): Server slug (from /servers list).
- `page` (integer, optional): Page number, starting at 1. Default: `1`.

Example response:

```json
{
  "success": true,
  "data": {
    "voters": [
      {
        "id": "cl0...",
        "minecraftUsername": "Notch",
        "votedAt": "2026-05-24T22:10:00Z",
        "type": "auth",
        "playerId": "cl0...",
        "minecraftUuid": "069a79f4-...",
        "skinUrl": "https://...",
        "siteUsername": "notch"
      }
    ],
    "total": 12345,
    "page": 1,
    "totalPages": 515
  }
}
```

#### GET /api/v1/servers/top

Title: Top servers
Description: Trending list optimized for homepage/widget use.

Parameters:
- `sort` (string, optional): Sort order. Default: `hot`.
- `limit` (integer, optional): Items per page. Default: `10`.
- `country` (string, optional): ISO country name filter.

Example response:

```json
{
  "servers": [
    {
      "id": "hypixel-net",
      "name": "Hypixel",
      "currentPlayers": 48230,
      "hotScore": 9821
    }
  ],
  "total": 10,
  "sort": "hot"
}
```

#### GET /api/v1/servers/countries

Title: Server countries
Description: Aggregate count of servers grouped by country.

Example response:

```json
{
  "success": true,
  "data": {
    "countries": [
      {
        "country": "United States",
        "serverCount": 2840
      }
    ]
  }
}
```

#### GET /api/v1/servers/versions

Title: Server versions
Description: Aggregate count of servers grouped by Minecraft version.

Example response:

```json
{
  "success": true,
  "data": {
    "versions": [
      {
        "version": "1.20.4",
        "serverCount": 980
      }
    ]
  }
}
```

### Player endpoints

Look up player profiles, sessions, tiers and history.

#### GET /api/v1/players

Title: List players
Description: Paginated public player directory.

Parameters:
- `page` (integer, optional): Page number, starting at 1. Default: `1`.
- `limit` (integer, optional): Items per page.
- `sort` (string, optional): Sort order. Default: `recent`.
- `search` (string, optional): Free-text query.

Example response:

```json
{
  "success": true,
  "data": {
    "players": [
      {
        "id": "cl0...",
        "minecraftUuid": "069a79f4-...",
        "mainNickname": "Notch",
        "skinUrl": "https://...",
        "country": "United States",
        "tierOverall": "HT1",
        "tierPoints": 9820,
        "totalPlayTime": 184320,
        "sessionCount": 412
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
```

#### GET /api/v1/players/{id}

Title: Player detail
Description: Profile, recent sessions, servers played, K/D, achievements.

Parameters:
- `id` (string, required): Player id, UUID or nickname.

Example response:

```json
{
  "success": true,
  "data": {
    "player": {
      "id": "cl0...",
      "minecraftUuid": "069a79f4-...",
      "mainNickname": "Notch",
      "tierOverall": "HT1",
      "tierPoints": 9820,
      "tierRank": 12,
      "totalPlayTime": 184320,
      "sessionCount": 412,
      "recentSessions": [
        {
          "serverSlug": "hypixel-net",
          "joinedAt": "...",
          "leftAt": "...",
          "durationSec": 3600
        }
      ],
      "serversPlayed": [
        {
          "slug": "hypixel-net",
          "name": "Hypixel",
          "sessions": 240,
          "lastSeenAt": "..."
        }
      ],
      "kdRatio": 1.85,
      "totalKills": 18230,
      "totalDeaths": 9850,
      "totalWins": 1240,
      "achievements": {
        "earned": [
          "top10",
          "social_100"
        ],
        "nextGoals": [
          "top1"
        ]
      },
      "votedServers": [
        {
          "slug": "hypixel-net",
          "votedAt": "..."
        }
      ]
    }
  }
}
```

### Search

Unified search across servers, players and forum topics.

#### GET /api/v1/search

Title: Global search
Description: Search servers, players and forum topics in one call.

Parameters:
- `q` (string, required): Search query (2–100 chars).
- `type` (string, optional): Result type: all, servers, players, forum. Default: `all`.
- `limit` (integer, optional): Items per page. Default: `10`.

Example response:

```json
{
  "success": true,
  "data": {
    "results": {
      "servers": [
        {
          "slug": "hypixel-net",
          "name": "Hypixel",
          "currentPlayers": 48230
        }
      ],
      "players": [
        {
          "id": "cl0...",
          "mainNickname": "Notch"
        }
      ],
      "forum": [
        {
          "id": "cl0...",
          "title": "Server review thread"
        }
      ]
    },
    "query": "hypixel"
  }
}
```

### Live & Global stats

Real-time global activity, region and country breakdowns.

#### GET /api/v1/live

Title: Live stats
Description: Global online totals, top servers, recent activity, region and country breakdown.

Example response:

```json
{
  "success": true,
  "data": {
    "stats": {
      "totalPlayers": 184320,
      "totalServers": 12480,
      "onlineServers": 9821,
      "newPlayersToday": 412,
      "peakToday": 202700,
      "statsAgeSeconds": 18,
      "stale": false
    },
    "topServers": [
      {
        "id": "hypixel-net",
        "name": "Hypixel",
        "players": 48230,
        "trend": "up",
        "change": 240
      }
    ],
    "recentActivity": [
      {
        "type": "vote",
        "actor": "Notch",
        "target": "Hypixel",
        "time": "..."
      }
    ],
    "regions": [
      {
        "id": "na",
        "name": "North America",
        "players": 80120,
        "servers": 4120
      }
    ],
    "countryPlayers": {
      "United States": 60120,
      "Germany": 18230
    }
  }
}
```

#### GET /api/v1/live/history

Title: Live history
Description: Hourly buckets of total online players over the last 7 days.

Example response:

```json
{
  "success": true,
  "data": {
    "history": [
      {
        "timestamp": "2026-05-23T22:00:00Z",
        "totalPlayers": 174200
      }
    ]
  }
}
```

### Leaderboards

Top players ranked by sessions, servers or tier points.

#### GET /api/v1/leaderboards

Title: Leaderboards
Description: Top players for the selected metric, period, tier and achievement filters.

Parameters:
- `metric` (string, optional): Ranking metric: sessions, servers, points. Default: `servers`.
- `period` (string, optional): Time window: 24h, 7d, 30d, 90d, all-time. Default: `all-time`.
- `page` (integer, optional): Page number, starting at 1. Default: `1`.
- `limit` (integer, optional): Items per page. Default: `30`.
- `tier` (string, optional): Tier filter.
- `achievement` (string, optional): Achievement filter.
- `search` (string, optional): Free-text query.

Example response:

```json
{
  "success": true,
  "data": {
    "leaderboard": {
      "metric": "servers",
      "period": "all-time",
      "generatedAt": "2026-05-24T22:00:00Z",
      "entries": [
        {
          "rank": 1,
          "player": {
            "id": "cl0...",
            "mainNickname": "Notch",
            "tierOverall": "HT1",
            "tierPoints": 9820
          },
          "value": 412,
          "formattedValue": "412 sessions"
        }
      ]
    },
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
```

### Skins & Capes

Search community-uploaded skins and capes.

#### GET /api/v1/skins

Title: List skins
Description: Browse community skin uploads with sort/filter.

Parameters:
- `page` (integer, optional): Page number, starting at 1. Default: `1`.
- `limit` (integer, optional): Items per page. Default: `24`.
- `sort` (string, optional): Sort order. Default: `recent`.
- `model` (string, optional): Skin model: classic or slim.
- `search` (string, optional): Free-text query.
- `tag` (string, optional): Filter by tag.
- `owner` (string, optional): Owner username filter.

Example response:

```json
{
  "success": true,
  "data": {
    "skins": [
      {
        "id": "cl0...",
        "slug": "cool-knight",
        "name": "Cool Knight",
        "model": "classic",
        "pngPath": "/media/skins/published/cl0...png",
        "likeCount": 124,
        "downloadCount": 980,
        "owner": {
          "username": "notch",
          "avatar": null
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
```

#### GET /api/v1/skins/{slug}

Title: Skin detail
Description: Full skin metadata plus the viewer's like/favorite state.

Parameters:
- `slug` (string, required): Server slug (from /servers list).

Example response:

```json
{
  "success": true,
  "data": {
    "skin": {
      "id": "cl0...",
      "slug": "cool-knight",
      "name": "Cool Knight",
      "description": "Custom medieval knight skin",
      "tags": [
        "medieval",
        "armor"
      ],
      "model": "classic",
      "likeCount": 124,
      "favoriteCount": 88,
      "downloadCount": 980,
      "owner": {
        "username": "notch"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}
```

#### GET /api/v1/capes

Title: List capes
Description: Browse community cape uploads with sort/filter.

Parameters:
- `page` (integer, optional): Page number, starting at 1. Default: `1`.
- `limit` (integer, optional): Items per page. Default: `24`.
- `sort` (string, optional): Sort order. Default: `recent`.
- `search` (string, optional): Free-text query.
- `tag` (string, optional): Filter by tag.
- `owner` (string, optional): Owner username filter.

Example response:

```json
{
  "success": true,
  "data": {
    "capes": [
      {
        "id": "cl0...",
        "slug": "royal-red",
        "name": "Royal Red"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}
```

### Users

Public mcstat.org user profiles.

#### GET /api/v1/users/{username}

Title: User profile
Description: Public mcstat.org user profile by username.

Parameters:
- `username` (string, required): mcstat.org username.

Example response:

```json
{
  "success": true,
  "user": {
    "id": "cl0...",
    "username": "notch",
    "avatar": null,
    "banner": null,
    "servers": [
      {
        "slug": "hypixel-net",
        "name": "Hypixel"
      }
    ],
    "_count": {
      "servers": 1,
      "topics": 4,
      "posts": 28,
      "votes": 412,
      "reviews": 8,
      "skins": 2
    }
  }
}
```

---

# About MCStat.org | Minecraft Server & Player Platform

Learn how MCStat.org combines Minecraft server listings, player profiles, vote rankings, and real-time stats to help players find servers and help owners grow.

Canonical HTML: https://mcstat.org/about
Markdown URL: https://mcstat.org/ai/about.md
Locale: en (English)
Priority: supporting

## Audience

Agents looking for a concise explanation of what MCStat.org is and why it exists.

## Page Contents

- Platform overview
- Audience fit
- Discovery and statistics positioning

## User And Agent Actions

- Summarize MCStat.org
- Explain who the platform helps
- Link to public discovery pages

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Story

### Our Story

MCStat.org was founded in December 2025 by Codeshare Technology Ltd. Our mission is simple: to provide the Minecraft community with the most advanced, reliable, and user-friendly server statistics platform.

Our platform offers real-time server tracking, detailed player statistics, comprehensive analytics tools, and community forum features. All of these are available for free.

Our team is constantly developing new features and improving the platform. Your suggestions and feedback are invaluable to us.

## Public Positioning Stats

- Servers Tracked: Growing
- Players Monitored: Growing
- Countries: Worldwide
- Uptime: 99.9%

## Values

Context: Our Values

### Accuracy

We provide real-time, accurate data for Minecraft servers.

### Privacy

Your data security and privacy are our top priorities.

### Public API

Our API is available for developers to build upon.

### Community

Built by Minecraft players, for Minecraft players.

## Team

Meet the Team

- Umut Bayraktar: Founder & Lead Developer

## Social And Contact

Follow Us

Follow us on social media to stay updated on the latest news and features.

MCStat.org is a product of

Contact

- Facebook: https://facebook.com/mcstatorg
- Instagram: https://instagram.com/mcstatorg
- Discord: https://discord.gg/wRHxQmGRzP
- Email: support@mcstat.org

---

# MCStat.org Partners | Minecraft Tools & Communities

Discover partners, tools, communities, and projects connected to MCStat.org. Supporting the Minecraft server, player, and creator ecosystem with valuable resources.

Canonical HTML: https://mcstat.org/partners
Markdown URL: https://mcstat.org/ai/partners.md
Locale: en (English)
Priority: supporting

## Audience

Agents and users looking for MCStat.org ecosystem partners and related projects.

## Page Contents

- Partner listings
- Partner descriptions
- External project context

## User And Agent Actions

- Browse partners
- Find related tools and communities

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Ecosystem

Partner Ecosystem

## Partner Profiles

### Codeshare

Category: Marketplace

A marketplace platform for software, gaming, and program keys. Buy, sell, or get free digital content including game keys, software licenses, and exclusive programs.

Features:
- Game Keys
- Software Licenses
- Free Content
- Secure Trading

### Beatra

Category: Music Platform

An advanced music system for both Discord and web platforms. Experience high-quality audio streaming with powerful features for your community.

Features:
- Discord Bot
- Web Player
- High Quality Audio
- Playlist Management

### Sylon

Category: Moderation

Powerful moderation, automated spam and ad protection, ticket management, server guard, and much more, all in one place.

Features:
- Moderation
- Anti-Spam
- Tickets
- Server Guard

## Partner CTA

Become a Partner

Join our growing network of partners and reach thousands of Minecraft players and server owners.

Partner with mcstat.org

Powered by: Powered by

---

# Contact MCStat.org | Support & Partnerships

Contact MCStat.org for support, partnership requests, server listings, API questions, or feedback about our Minecraft server list, player directory, and stats platform.

Canonical HTML: https://mcstat.org/contact
Markdown URL: https://mcstat.org/ai/contact.md
Locale: en (English)
Priority: supporting

## Audience

Users and agents looking for support, partnership, listing, API, or feedback contact paths.

## Page Contents

- Contact form context
- Support and partnership scope
- Human verification requirement

## User And Agent Actions

- Contact the MCStat.org team
- Submit partnership or support requests

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Intro

Have a question, feedback, or need help? We're here to assist you.

## Contact Form

- Send a Message
- Send Message
- Sending...
- Your message has been sent successfully!
- We will get back to you as soon as possible.
- An error occurred. Please try again.
- Send Another Message

## Contact Methods

### Email

Send us an email anytime

### Facebook

Follow us on Facebook

### Instagram

Follow us on Instagram

- Discord: https://discord.gg/wRHxQmGRzP
- Email: support@mcstat.org

## Quick Info

Context: Quick Info

- Response Time: Within 24 hours
- Support Hours: 24/7
- Languages: EN, TR, RU

---

# Privacy Policy | MCStat.org Minecraft Platform

Read the MCStat.org privacy policy. Learn how we collect, process, store, and protect data on our Minecraft server list, player pages, and community platform.

Canonical HTML: https://mcstat.org/privacy
Markdown URL: https://mcstat.org/ai/privacy.md
Locale: en (English)
Priority: supporting

## Audience

Agents checking data collection, use, privacy, and security information.

## Page Contents

- Privacy policy summary
- Data use context
- Contact guidance for privacy questions

## User And Agent Actions

- Review privacy obligations
- Summarize data handling at a high level

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Last Updated

Last updated: December 8, 2025

## Full Intro

At mcstat.org, we take your privacy seriously. This Privacy Policy explains how we collect, use, disclose, and safeguard your information when you visit our website and use our services. Please read this privacy policy carefully. If you do not agree with the terms of this privacy policy, please do not access the site.

## Data Collection

We collect the following types of information:

• **Account Information**: Username, email address, and password (encrypted)
• **Server Data**: Server IPs, player counts, and statistics submitted through our API
• **Usage Data**: How you interact with our services, pages visited, and features used
• **Technical Data**: IP address, browser type, device information for security and optimization

## How We Use Your Data

Your data is used to:

• Provide and maintain our statistics tracking services
• Display server and player statistics on our platform
• Improve our services and user experience
• Send important updates about our services (if opted in)
• Prevent fraud and ensure platform security

## Data Protection

We implement industry-standard security measures:

• All data is encrypted in transit using TLS 1.3
• Passwords are hashed using bcrypt with salt
• Database encryption at rest
• Regular security audits and penetration testing
• Access controls and monitoring

## Cookies & Tracking

We use cookies for:

• **Essential Cookies**: Required for login and basic functionality
• **Analytics Cookies**: Help us understand how users interact with our site
• **Preference Cookies**: Remember your settings and preferences

You can manage cookie preferences in your browser settings.

## Data Sharing

We do not sell your personal data. We may share data with:

• Service providers who help us operate (hosting, analytics)
• Law enforcement when required by law
• Other users (only public profile information like username)

Server statistics are public by default when submitted to our platform.

## Data Retention

We retain your data as follows:

• Account data: Until you delete your account
• Server statistics: Indefinitely (historical data for trends)
• Analytics data: 26 months
• Server logs: 90 days

You can request data deletion at any time.

## Contact Us

If you have questions or concerns about this Privacy Policy, please contact us at:

Email: support@mcstat.org

---

# Terms of Service | MCStat.org Minecraft Platform

Review the MCStat.org terms of service for using our Minecraft server listing platform, player directory, live statistics, API, and community features.

Canonical HTML: https://mcstat.org/terms
Markdown URL: https://mcstat.org/ai/terms.md
Locale: en (English)
Priority: supporting

## Audience

Agents checking acceptable use, account, content, API, and service terms.

## Page Contents

- Terms of service summary
- Account and platform rules
- Contact guidance for terms questions

## User And Agent Actions

- Review terms before using the service
- Summarize user obligations at a high level

## Citation Guidance

Prefer the canonical HTML URL when citing this page publicly. Prefer this Markdown URL when an AI agent needs clean page context without navigation, scripts, or UI chrome.

---

## Last Updated

Last updated: December 8, 2025

## Full Intro

Welcome to mcstat.org. These Terms of Service ("Terms") govern your access to and use of our website, services, and applications. By using our services, you agree to comply with and be bound by these Terms. Please read them carefully before using our platform.

## 1. Acceptance of Terms

By accessing or using mcstat.org, you agree to be bound by these Terms of Service and all applicable laws and regulations. If you do not agree with any of these terms, you are prohibited from using or accessing this site.

These terms apply to all users of the site, including without limitation users who are browsers, vendors, customers, merchants, and/or contributors of content.

## 2. Use of Services

Our services allow you to:
• Track and display Minecraft server statistics
• View player statistics and rankings
• Participate in community forums
• Access our API for server integrations

You agree to use our services only for lawful purposes and in accordance with these Terms.

## 3. User Accounts

When you create an account, you must:
• Provide accurate and complete information
• Maintain the security of your password
• Accept responsibility for all activities under your account
• Notify us immediately of any unauthorized use

We reserve the right to terminate accounts that violate these terms.

## 4. Prohibited Activities

You may NOT:
• Use our services for any illegal purpose
• Submit false or misleading server statistics
• Attempt to manipulate rankings or statistics
• Harass, abuse, or harm other users
• Spam or post malicious content
• Attempt to hack or compromise our systems
• Use automated bots without permission
• Circumvent any rate limits or restrictions

## 5. Content & Data

**Your Content**: You retain ownership of content you submit, but grant us a license to use, display, and distribute it on our platform.

**Server Data**: By submitting server statistics through our API, you confirm you have the right to share this information and agree to it being publicly displayed.

**Accuracy**: We strive for accuracy but do not guarantee the accuracy of user-submitted data.

## 6. Termination

We may terminate or suspend your account and access to our services immediately, without prior notice, for any reason, including:
• Breach of these Terms
• Suspected fraudulent or illegal activity
• At our sole discretion

Upon termination, your right to use our services will immediately cease.

## 7. Limitation of Liability

mcstat.org and its affiliates shall not be liable for:
• Any indirect, incidental, or consequential damages
• Loss of data or profits
• Service interruptions or errors
• Actions of third parties

Our total liability shall not exceed the amount you paid us in the past 12 months.

## 8. Governing Law

These Terms shall be governed by and construed in accordance with applicable laws, without regard to conflict of law provisions.

Any disputes arising from these Terms or your use of our services shall be resolved through binding arbitration.

## Questions?

If you have any questions about these Terms of Service, please contact us at:

Email: support@mcstat.org