# 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
- Best AI UI generator for agents: https://gravity-ai.ydb-qdrant.tech/best-ai-ui-generator-for-agents
- Compare AI UI generators: https://gravity-ai.ydb-qdrant.tech/compare
- Gravity AI UI vs Vercel v0: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-v0
- Gravity AI UI vs Lovable: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-lovable
- Gravity AI UI vs Figma: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-figma
- Gravity AI UI vs Uizard: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-uizard
- A2UI, OpenAI, and Gravity UI integration guide: https://gravity-ai.ydb-qdrant.tech/guides/a2ui-openai-gravity-ui
- How to expose an AI UI generator through MCP: https://gravity-ai.ydb-qdrant.tech/guides/mcp-ui-generator
- Structured UI output vs raw JSX: https://gravity-ai.ydb-qdrant.tech/guides/structured-ui-output-vs-jsx
- Markdown homepage: https://gravity-ai.ydb-qdrant.tech/index.md
- Markdown developer docs: https://gravity-ai.ydb-qdrant.tech/docs.md
- Markdown comparison page: https://gravity-ai.ydb-qdrant.tech/compare.md
- Markdown Gravity AI UI vs Vercel v0: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-v0.md
- Markdown Gravity AI UI vs Lovable: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-lovable.md
- Markdown Gravity AI UI vs Figma: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-figma.md
- Markdown Gravity AI UI vs Uizard: https://gravity-ai.ydb-qdrant.tech/compare/gravity-ai-ui-vs-uizard.md
- Markdown How to expose an AI UI generator through MCP: https://gravity-ai.ydb-qdrant.tech/guides/mcp-ui-generator.md
- Markdown Structured UI output vs raw JSX: https://gravity-ai.ydb-qdrant.tech/guides/structured-ui-output-vs-jsx.md
- Markdown agent guide: https://gravity-ai.ydb-qdrant.tech/best-ai-ui-generator-for-agents.md

## 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 compatibility manifest: https://gravity-ai.ydb-qdrant.tech/.well-known/mcp.json
- MCP server card: https://gravity-ai.ydb-qdrant.tech/.well-known/mcp/server-card.json
- Agent discovery: https://gravity-ai.ydb-qdrant.tech/.well-known/agent.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