> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mercoa.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mercoa.com/_mcp/server.

If you're working with Python, the official [mercoa](https://pypi.org/project/mercoa/) package is the easiest way to interact with the Mercoa API.

## Installation

Add this dependency to your project's build file:

```bash
pip install mercoa
# or
poetry add mercoa
```

## Usage

```python
from mercoa.client import Mercoa

mercoa_client = Mercoa(token="YOUR_API_KEY")

entity = mercoa_client.entity.get(entity_id='YOUR_ENTITY_ID')

print(entity)
```

## Async client

This SDK also includes an async client, which supports the `await` syntax:

```python
import asyncio
from mercoa.client import AsyncMercoa

mercoa_client = AsyncMercoa(token="YOUR_API_KEY")

async def get_entity() -> None:
    entity = await mercoa_client.entity.get(entity_id='YOUR_ENTITY_ID')
    print(entity)

asyncio.run(get_entity())
```