# Humanitix — how to use (mcp.ai)

Connect your Humanitix account and use 3 tools for event management straight from your AI agent. Connect with your own API key. Humanitix is a not-for-profit ticketing platform that donates 100% of its profits to charity.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_humanitix?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `humanitix_get_event`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/humanitix`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/humanitix/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/humanitix/get/event` — Tool to retrieve detailed information about a specific event. Use when you have the eventId and need full metadata.
  - body: { event_id: string }
- `POST https://api.mcp.ai/api/humanitix/get/events` — Tool to retrieve a paginated list of events from your Humanitix account. Use when you need to page through your events after confirming API key validity.
  - body: { page: integer, since?: string, pageSize?: integer, inFutureOnly?: boolean, overrideLocation?: string }
- `POST https://api.mcp.ai/api/humanitix/get/tags` — Tool to get all tags associated with your Humanitix account. Use when you need to list or paginate through tags after setting up your API key.
  - body: { page?: integer }

## Example prompts
- "What can I do in Humanitix?"
- "Show me a summary of my Humanitix account"

## More
- Page: https://mcp.ai/humanitix
- Agent spec (llms.txt): https://mcp.ai/humanitix/llms.txt
- Postman collection: https://mcp.ai/humanitix/postman.json