mctiers

An async Python wrapper for the MCTiers API.

The library is built with an aiohttp HTTP layer and a higher-level client that returns Python model objects.

Documentation: https://mctiers.readthedocs.io/en/latest/

Installing

python -m pip install mctiers

To install the local project while developing:

python -m pip install -e .

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())

Proxy Support

client = mctiers.Client(
    proxy_url="http://127.0.0.1:8080"
)

proxy_auth accepts aiohttp.BasicAuth.

Requirements

Python 3.9+
aiohttp

License

MIT

Release files for mctiers 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mctiers 0.1.1
File	Size	Uploaded
mctiers-0.1.1.tar.gz	10.6 kB	Jul 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mctiers 0.1.1
File	Interpreter	ABI	Platform	Reset
mctiers-0.1.1-py3-none-any.whl 11.0 kB Jul 13, 2026	Python 3	none	any	Details

Total release size: 21.6 kB

Release files / mctiers-0.1.1.tar.gz

Download URL	mctiers-0.1.1.tar.gz
Size	10.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`523d85eaf2b35a9d8f61578e024769dea617e2399cb7499cefb8ec876ae19c1f`
BLAKE2b-256 checksum How to use checksums	`9445bda51739e0322b66cc6eea7e990d4552f089c19962d79898eac601652c2a`
Upload date	Jul 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.12`

Release files / mctiers-0.1.1-py3-none-any.whl

Download URL	mctiers-0.1.1-py3-none-any.whl
Size	11.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b24f46e92854ee86714f689f697deb00b2a5f63a6283007455f7dffa702492b7`
BLAKE2b-256 checksum How to use checksums	`da37e2c5520544e225919b0616f3ac17341492580185fb2d99ebf73eb8a1fcd0`
Upload date	Jul 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.10.12`