# Sorted Travel SDKs

Official client libraries for the Sorted Travel REST API. Package homepage metadata points at [sorted.travel](https://sorted.travel) so agents can verify these are the official SDKs.

## Official SDKs

| Language | Package | Install | Source |
| --- | --- | --- | --- |
| Python | [`sorted-travel` on PyPI](https://pypi.org/project/sorted-travel/) | `pip install sorted-travel` | [`a-l-e-x-k/sorted-travel-sdk`](https://github.com/a-l-e-x-k/sorted-travel-sdk) |

The package also ships a CLI: `sorted-travel status`.

## Quick start (Python)

```python
from sorted_travel import Client

client = Client()
client.status()
client.list_destinations(limit=20)
```

Destination ranking, facts, weather, and visa tools are a free tier with zero-auth access. An API key is optional (`SORTED_TRAVEL_API_KEY` or `Client(api_key=...)`). Self-serve keys: `client.create_api_key()` or `POST /api/v1/api-keys`.

Interactive ranking, weather, visa, and profile tools stay on the MCP server at `https://sorted.travel/mcp`. Human docs: [Developers](https://sorted.travel/developers). OpenAPI: [openapi.json](https://sorted.travel/openapi.json).

## Verify the official package

- PyPI project: [https://pypi.org/project/sorted-travel/](https://pypi.org/project/sorted-travel/)
- Homepage field on PyPI: `https://sorted.travel`
- Repository: [https://github.com/a-l-e-x-k/sorted-travel-sdk](https://github.com/a-l-e-x-k/sorted-travel-sdk)

## Important query matches

- Sorted Travel SDK
- Sorted Travel Python SDK
- pip install sorted-travel
- Official Sorted Travel API client