mctiers.py¶

An async Python wrapper for the public MCTiers API.

mctiers.py uses aiohttp and exposes a small object-oriented client for fetching gamemodes, rankings, player profiles, and test history.

Features¶

Modern async API using async and await
Built-in retry handling for temporary server errors
Rate-limit handling for 429 responses and Retry-After headers
Typed model objects for common API payloads
Proxy and custom aiohttp session support

Installing¶

python -m pip install mctiers

Quick Example¶

import asyncio
import mctiers


async def main() -> None:
    async with mctiers.Client() as client:
        profile = await client.fetch_player_profile_by_name(
            "ItzRealMe",
            badges=True,
            tests=True,
        )

        print(profile.name)
        print(profile.points)


asyncio.run(main())

Contents¶