# Evenium — how to use (mcp.ai)

Connect your Evenium account and use 12 tools for event management straight from your AI agent. Connect with your own API key. Evenium is an all-in-one event management platform that simplifies the planning, execution, and analysis of professional events.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_evenium?ms=1787295840000`
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. `evenium_create_contact`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/evenium`
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/evenium/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/evenium/create/contact` — Tool to create a new contact in the Evenium address book. Use when you need to add a new contact with basic information (name, email, company) and optional custom fields.
  - body: { email?: string, fields?: object[], gender?: string, company?: string, customId?: string, lastName?: string, firstName?: string }
- `POST https://api.mcp.ai/api/evenium/delete/contact` — Tool to permanently remove a contact from the Evenium address book. Use when you need to delete a contact by their ID. WARNING: This operation is irreversible and deletes all associated guests in casc
  - body: { contactId: string }
- `POST https://api.mcp.ai/api/evenium/get/contact` — Tool to retrieve a single contact by ID from Evenium. Use when you need to fetch details for a specific contact using either Evenium internal ID or custom external ID.
  - body: { contactId: string }
- `POST https://api.mcp.ai/api/evenium/get/contact/by/custom/id` — Tool to retrieve a specific contact from Evenium by their custom ID (external database ID). Use when you need to look up a contact using an identifier from your own CRM or database system.
  - body: { customId: string }
- `POST https://api.mcp.ai/api/evenium/get/contact/events` — Tool to retrieve all events that a contact has been invited to or registered for. Use when you need to see a contact's event history with registration details.
  - body: { contactId: string, endsAfter?: string, endsBefore?: string, startsAfter?: string, createdAfter?: string, startsBefore?: string, createdBefore?: string }
- `POST https://api.mcp.ai/api/evenium/get/contact/events/by/custom/id` — Retrieves all events a contact has been invited to using their custom ID. Use this when you need to find all events associated with a specific contact identified by a custom ID from your database.
  - body: { customId: string, endsAfter?: string, endsBefore?: string, startsAfter?: string, createdAfter?: string, startsBefore?: string, createdBefore?: string }
- `POST https://api.mcp.ai/api/evenium/get/contacts` — Tool to retrieve a list of contacts from Evenium. Use when you need to fetch and optionally filter organizer contacts.
  - body: { page?: integer, order?: string, search?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/evenium/get/events` — Retrieves a paginated list of events from Evenium with optional filtering and sorting. Use this to list all events or search for specific events by title, code, or location. Supports pagination via st
  - body: { sort?: string, limit?: integer, start?: integer, search?: string, archived?: boolean, direction?: string, includeDrafts?: boolean, includeDeleted?: boolean }
- `POST https://api.mcp.ai/api/evenium/import/contacts` — Tool to import multiple contacts at once (batch import). Creates new contacts or updates existing ones based on customId or email matching. Use when you need to bulk create or update contacts in Eveni
  - body: { contacts: object[] }
- `POST https://api.mcp.ai/api/evenium/logout` — Tool to log out the current user and invalidate the session token. Use when you need to explicitly end the current session.
- `POST https://api.mcp.ai/api/evenium/update/contact` — Tool to update an existing contact in Evenium by contact ID. Use when you need to modify contact details such as email, name, company, or custom fields.
  - body: { email?: string, phone?: string, state?: string, fields?: object[], company?: string, country?: string, lastName?: string, contactId: string, firstName?: string, organization?: string }
- `POST https://api.mcp.ai/api/evenium/update/contact/by/custom/id` — Tool to update a contact in Evenium by custom ID (external ID from your CRM/database). Use when you need to update contact details using your own identifier rather than Evenium's internal ID.
  - body: { email?: string, fields?: object[], company?: string, customId: string, lastName?: string, firstName?: string }

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

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