# Eventry Platform API

> Eventry is a multi-tenant event management platform. The API lets you create events, manage registrations, handle payments, issue certificates, and build community portals via collections.

## API Basics

- Base URL: `https://api.eventry.com/api/v1`
- Auth URL: `https://auth.eventry.com/realms/eventry-platform`
- Format: JSON, REST, URL-versioned (v1)
- Errors: RFC 7807 Problem Details
- Multi-tenant: requires `X-Tenant-Id` header on tenant-scoped endpoints

## Authentication

Two methods:

1. **API Key** — `Authorization: Bearer eventry_live_...` (server-to-server)
2. **OAuth2 (Keycloak)** — Password grant or Authorization Code + PKCE

Token endpoint:
```
POST https://auth.eventry.com/realms/eventry-platform/protocol/openid-connect/token
```

## Key Resources

- **Events** — Create, update, publish events with pricing, forms, and capacity
- **Registrations** — Register participants, approve/reject, check-in
- **Participants** — Manage attendee data, GDPR export/deletion
- **Payments** — Stripe checkout, invoices, refunds, split payments
- **Collections** — Group events into public portals, invite members
- **Forms** — Dynamic registration forms with validation and pricing rules
- **Certificates** — Generate and verify attendance certificates
- **Webhooks** — Real-time event notifications (registration.created, payment.succeeded, etc.)
- **Translations** — Multi-language content support

## Documentation

- OpenAPI Spec: https://api.eventry.com/openapi/v1.json
- Interactive API Reference: https://api.eventry.com/scalar/v1
- Full AI Reference: https://www.eventry.com/llms-full.txt
- Getting Started: https://api.eventry.com/docs/getting-started
- Authentication: https://api.eventry.com/docs/authentication
- Webhooks: https://api.eventry.com/docs/webhooks
- Integration Guide: https://api.eventry.com/docs/integration-guide

## MCP (Model Context Protocol)

Eventry supports MCP for AI tool integration. Connect any MCP-compatible client (Claude, Cursor, VS Code, etc.) to manage events, registrations, participants, and more.

- MCP Endpoint: `https://mcp.eventry.com/mcp` (Streamable HTTP transport)
- Discovery: `https://mcp.eventry.com/.well-known/mcp.json`
- Auth: `Authorization: Bearer eventry_live_...` (your API key)

### Available Tools

- **ListEvents / GetEvent / CreateEvent / UpdateEvent** — Event CRUD
- **GetEventRegistrationForm** — Get form fields, ticket types, and event info needed to register
- **CreateRegistration** — Register a participant (with form answers, attendees, tickets)
- **ListRegistrations / GetRegistration** — Query registrations
- **ApproveRegistration / CancelRegistration / CheckInParticipant** — Manage registration status
- **ListParticipants / GetParticipant** — Participant lookup
- **ListCollections / GetCollection / GetCollectionBySlug** — Collection/portal management
- **ListCollectionMembers / ListCollectionTags** — Collection members and tags
- **GetReportSummary / GetReportRegistrations** — Reporting