> For the complete documentation index, see [llms.txt](https://eventx-hq.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eventx-hq.gitbook.io/knowledge-base/api-v2/mcp-server-ai-agent-access.md).

# MCP Server (AI Agent Access)

An [Model Context Protocol](https://modelcontextprotocol.io) server is exposed at `/mcp` for AI agents to query and manage event data.

* **Endpoint:** `{server}/mcp`
* **Auth:** send an **organizer API token** on every request as `Authorization: Bearer evtx_live_…` (Org- or Event-scoped; `read` suffices for read tools, `write` required for promo-code writes).
* **Scope:** **Org/Event scoped (not user-scoped)**. An Org-scoped token can access every event in the organization; an Event-scoped token only the single event it was issued for. Read tools: list events, list/get attendees, tickets, addons, promo codes, check-in sessions/check-ins. Write tools: create/patch/delete promo codes and check-ins require `write` permission and explicit human confirmation (`confirm:true`).
* **Install guide:** see `docs/mcp-guide.md` in the repository for connecting Claude Desktop, Cursor, and other MCP clients.