# Gravity AI UI Developer Docs

Gravity AI UI API docs for AI agents and developers. Generate, preview, inspect, and reuse AI-built product interfaces with A2UI, OpenAI, and Gravity UI.

## Predictable URLs

- OpenAPI spec: https://gravity-ai.ydb-qdrant.tech/openapi.json
- MCP server: https://gravity-ai.ydb-qdrant.tech/mcp
- MCP discovery: https://gravity-ai.ydb-qdrant.tech/.well-known/mcp
- MCP server card: https://gravity-ai.ydb-qdrant.tech/.well-known/mcp/server-card.json
- OAuth metadata: https://gravity-ai.ydb-qdrant.tech/.well-known/oauth-authorization-server
- OAuth protected resource: https://gravity-ai.ydb-qdrant.tech/.well-known/oauth-protected-resource
- Full agent docs: https://gravity-ai.ydb-qdrant.tech/llms-full.txt

## API endpoints

- `POST /api/agent` streams Server-Sent Events for prompt and action requests.
- `POST /api/design-feedback` publishes liked generated interfaces to the public gallery.
- `POST /mcp` exposes the Streamable HTTP MCP server for tool-capable agents.
- Related MCP docs: https://gravity-ai.ydb-qdrant.tech/mcp.md

## Rate limits and retries

The public demo is intended for low-volume interactive evaluation. Agents should retry with backoff, send `Idempotency-Key` on mutation attempts, and respect `RateLimit-*` or `Retry-After` headers when they are present.