# Eventi API and agent surface

> Scoped index for the Eventi API and agent-integration resources. For the full site index see https://ueventi.com/llms.txt.

## Reference
- [Developer hub](https://ueventi.com/developers): Every Eventi developer and agent resource, linked by name.
- [OpenAPI spec (JSON)](https://ueventi.com/openapi.json): Machine-readable description of the public API.
- [OpenAPI spec (YAML)](https://ueventi.com/openapi.yaml): Same spec, YAML.
- [Authentication guide](https://ueventi.com/auth.md): The public endpoints need no credentials; rate limited by IP. Discovery URLs, curl example, error codes.

## Endpoints
- [POST https://app.ueventi.com/api/tools/render-invitation](https://app.ueventi.com/api/tools/render-invitation): Render a designed invitation card as a PNG. No auth, CORS open, 30 requests/hour/IP. JSON in, image/png out.
- [GET https://app.ueventi.com/api/health](https://app.ueventi.com/api/health): Service health check. Returns {"status":"ok"}.

## Agent integration
- [MCP server](https://ueventi.com/mcp): Model Context Protocol endpoint with three public tools, over Streamable HTTP.
- [MCP server card](https://ueventi.com/.well-known/mcp/server-card.json): Describes the MCP endpoint and its capabilities.
- [API catalog](https://ueventi.com/.well-known/api-catalog): RFC 9727 index of every Eventi API.
- [Agent skills](https://ueventi.com/.well-known/agent-skills/index.json): Discoverable skills index.
- [NLWeb ask endpoint](https://ueventi.com/ask): Ask a natural-language question about Eventi and get a grounded answer.
- [Agent view](https://ueventi.com/?mode=agent): Append ?mode=agent to any page for an agent-optimized view.

## Free tools
- [Invitation card maker](https://ueventi.com/invitation-maker): Free, no-login tool that renders an invitation PNG - the web front end for the render-invitation API.