# Gravity AI UI

> Gravity AI UI API docs and complete agent documentation. Generate, preview, inspect, and reuse AI-built product interfaces with A2UI, OpenAI, and Gravity UI.

## Product summary

Gravity AI UI is an AI-powered UI generator for product interfaces. It turns natural-language prompts into validated A2UI component trees, renders them with trusted Gravity UI components, exposes copyable React code, and lets users publish liked designs to a gallery.

## Core links

- App: https://gravity-ai.ydb-qdrant.tech/
- Gallery: https://gravity-ai.ydb-qdrant.tech/gallery
- Developer docs: https://gravity-ai.ydb-qdrant.tech/docs
- Compare AI UI generators: https://gravity-ai.ydb-qdrant.tech/compare
- A2UI, OpenAI, and Gravity UI integration guide: https://gravity-ai.ydb-qdrant.tech/guides/a2ui-openai-gravity-ui

## API reference

- OpenAPI spec: https://gravity-ai.ydb-qdrant.tech/openapi.json
- `POST /api/agent`: stream generated interface events.
- `POST /api/design-feedback`: publish liked interface feedback.
- API responses use structured JSON errors with `error.code` and `error.message` where routes are handled directly by the app.

## MCP

- 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
- Tools: `search_interfaces`, `get_interface`, `generate_interface`, `refine_interface`.

```bash
curl -X POST https://gravity-ai.ydb-qdrant.tech/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## Auth

OAuth metadata is published for agent discovery, but bearer-token enforcement and token issuance are not enabled in this public demo.
- OAuth metadata: https://gravity-ai.ydb-qdrant.tech/.well-known/oauth-authorization-server
- Protected resource metadata: https://gravity-ai.ydb-qdrant.tech/.well-known/oauth-protected-resource

## Webhooks

Webhooks are not currently supported. Agents should call the API or MCP server directly and should not attempt webhook registration.

## Rate limits

Use low-volume interactive requests. Respect `RateLimit-*` and `Retry-After` headers when present, and retry transient errors with backoff.

## Stack

- Next.js 16
- React 19
- TypeScript
- A2UI
- OpenAI
- Gravity UI
- SCSS