--- title: "Eventi for developers and AI agents - Eventi" description: "Every Eventi developer and agent resource in one place: the Eventi Public API and OpenAPI spec, the Eventi MCP server, agent skills, the API catalog, the auth guide, llms.txt, markdown twins, the free invitation-card maker, and the NLWeb ask endpoint." canonical: https://ueventi.com/developers last-updated: 2026-10-15 --- Developers # Eventi for developers and AI agents Every Eventi developer and agent resource in one place, each at a predictable URL: the Eventi Public API and OpenAPI spec, the MCP server, agent skills, the API catalog, the auth guide, the llms.txt family and markdown twins, the free invitation-card maker, and the NLWeb ask endpoint. The public endpoints need no account - the rest of the platform is behind the dashboard at [https://app.ueventi.com/login](https://app.ueventi.com/login). ## Eventi REST API v1 A workspace's events, guest lists, RSVP summaries, guest creation (single and batch) and CSV exports at api.ueventi.com/v1, with a Bearer API key scoped to events:read, guests:read, guests:write or exports:write. Cursor paging, idempotent writes, RateLimit headers, JSON errors with a how\_to\_fix, and a no-key sandbox that mirrors every endpoint with canned data. [api.ueventi.com/v1](https://api.ueventi.com/v1)[sandbox](https://api.ueventi.com/v1/sandbox/events)[sandbox guide](https://ueventi.com/sandbox)[API keys](https://app.ueventi.com/dashboard/settings/api-keys)[agent guide](https://ueventi.com/agent) ## Eventi agent files Skill-style markdown an agent can read and follow: agents.md walks through setup (key, MCP, skill, CLI, sandbox), skill.md lists every v1 action with its scope, and auth.md is the auth.md-convention reference with the agent\_auth block and every discovery URL. [agents.md](https://ueventi.com/agents.md)[skill.md](https://ueventi.com/skill.md)[auth.md](https://ueventi.com/auth.md)[changelog](https://ueventi.com/changelog) ## Eventi Public API The public REST surface. Today it is the invitation-card renderer - POST event details, get a designed PNG back, no auth, CORS open, 30 requests per hour per IP - plus a health check. Described as a machine-readable OpenAPI 3.1 document in JSON and YAML for code generation and agent tool discovery. [openapi.json](https://ueventi.com/openapi.json)[openapi.yaml](https://ueventi.com/openapi.yaml)[POST /api/v1/tools/render-invitation](https://app.ueventi.com/api/v1/tools/render-invitation) ## Eventi API versioning and deprecation policy The Eventi Public API is versioned in the URL path, and the current version is v1. A breaking change ships under a new prefix such as /v2 and never changes a v1 response in place; additive changes like a new optional field can land in v1. Before any endpoint or version is removed, its responses carry Deprecation (RFC 9745) and Sunset (RFC 8594) headers with the removal date at least 90 days ahead, and the change is listed on this page and in the changelog. Nothing is deprecated today. The older unversioned renderer path stays available as an alias of v1. The same policy is served as JSON from the API host, and the API index at https://api.ueventi.com/ links to it. [policies/deprecation (JSON)](https://api.ueventi.com/v1/policies/deprecation)[changelog](https://ueventi.com/changelog)[openapi.json](https://ueventi.com/openapi.json) ## Eventi API rate limits and retries The renderer allows 30 requests per hour per IP. Every response reports the budget in RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy headers, and a 429 adds Retry-After with the seconds to wait. Rendering is deterministic and has no side effects, so retrying the same request is always safe; send an Idempotency-Key header to correlate retries and it is echoed back. [auth.md](https://ueventi.com/auth.md) ## Eventi MCP server The Eventi Model Context Protocol server lets AI agents call Eventi as native tools over Streamable HTTP. Three public tools are exposed. The server card describes the endpoint and its capabilities for automated discovery. [MCP server](https://ueventi.com/mcp)[MCP server card](https://ueventi.com/.well-known/mcp/server-card.json)[mcp.json](https://ueventi.com/.well-known/mcp.json)[docs MCP](https://app.ueventi.com/docs/mcp) ## Eventi agent skills A machine-readable index of the agent skills Eventi publishes, so coding agents and assistants can discover what Eventi can do and how to invoke it. [agent-skills/index.json](https://ueventi.com/.well-known/agent-skills/index.json) ## Eventi agent resource catalog An Agentic Resource Discovery (ARD) catalog that lists every agent-facing Eventi resource in one document - the MCP server, the A2A agent card, the agent skills and the OpenAPI spec - each with a stable urn:air identifier. The same document is served at the AI Catalog path, and robots.txt points to it with an Agentmap directive. [ard.json](https://ueventi.com/.well-known/ard.json)[ai-catalog.json](https://ueventi.com/.well-known/ai-catalog.json) ## Eventi API catalog The RFC 9727 API catalog: one machine-readable index that points at every Eventi API and its OpenAPI description, for agents that start from a well-known URL. [api-catalog](https://ueventi.com/.well-known/api-catalog) ## Eventi authentication guide How to authenticate to the Eventi API: a Bearer API key (ev\_live\_) with scopes, created in the dashboard. The guide covers the discovery metadata (RFC 8414 and 9728), the agent\_auth block, rate limits, every error code and revocation, plus the parts that need no key at all. [auth.md](https://ueventi.com/auth.md)[oauth-authorization-server](https://ueventi.com/.well-known/oauth-authorization-server)[oauth-protected-resource](https://ueventi.com/.well-known/oauth-protected-resource) ## Eventi llms.txt and markdown twins Indexes and content built for agents and crawlers. llms.txt is the site index, llms-full.txt the expanded version, and api/llms.txt a scoped index of just the API and agent surface. Every content page also has a markdown twin: append .md to any page URL, or send an Accept: text/markdown header. Each page advertises its twin in a Link response header, each twin opens with title, description, canonical and last-updated frontmatter, and schemamap.xml lists the pages that carry schema.org structured data. [llms.txt](https://ueventi.com/llms.txt)[llms-full.txt](https://ueventi.com/llms-full.txt)[api/llms.txt](https://ueventi.com/api/llms.txt)[schemamap.xml](https://ueventi.com/schemamap.xml) ## Eventi free invitation-card maker A free, no-login tool that designs an invitation card from your event details and hands back a PNG. The web tool and the API endpoint that powers it share the same renderer. [Invitation maker](https://ueventi.com/invitation-maker)[render-invitation API](https://app.ueventi.com/api/v1/tools/render-invitation) ## Eventi NLWeb ask endpoint and agent view Ask Eventi a natural-language question about how it works and get a grounded answer over the NLWeb /ask endpoint. Every page also serves an agent-optimized view: append ?mode=agent to strip the page down to its structured content. [/ask](https://ueventi.com/ask)[?mode=agent view](https://ueventi.com/?mode=agent)