OpenAPI spec
OpenAPI 3.1 reference for /api/agent, /api/design-feedback, /mcp, OAuth discovery, and function-calling agents.
https://gravity-ai.ydb-qdrant.tech/openapi.jsonGravity AI UI Developer Docs
API docs for agents and developers integrating with Gravity AI UI. The public surfaces include an OpenAPI spec, a Streamable HTTP MCP server, OAuth discovery metadata, markdown docs, structured errors, and documented webhooks status.
OAuth
Metadata-only OAuth 2.0 and OpenID Connect discovery. Token issuance is not enabled in the current public demo.
https://gravity-ai.ydb-qdrant.tech/.well-known/oauth-authorization-serverMCP server
Pre-connection MCP server card with Streamable HTTP transport details and the public tool list.
https://gravity-ai.ydb-qdrant.tech/.well-known/mcp/server-card.jsonAgent discovery
Generic agent discovery document with product capabilities, OpenAPI, OAuth metadata, MCP links, and llms.txt.
https://gravity-ai.ydb-qdrant.tech/.well-known/agent.jsonMarkdown docs
Heading-led markdown fallback for agents that prefer text resources over rendered HTML pages.
https://gravity-ai.ydb-qdrant.tech/docs.mdMCP UI generator guide
How to expose an AI UI generator through MCP with structured A2UI output, OpenAPI, markdown docs, and React export artifacts.
https://gravity-ai.ydb-qdrant.tech/guides/mcp-ui-generatorStructured UI output guide
Why structured A2UI-style output is safer and easier for agents to reuse than raw JSX or HTML generation.
https://gravity-ai.ydb-qdrant.tech/guides/structured-ui-output-vs-jsxwebhooks
Current webhook support status. Gravity AI UI does not support webhook registration yet; agents should use direct API or MCP calls.
https://gravity-ai.ydb-qdrant.tech/webhooks.mdRemote MCP
Connect coding agents to public gallery lookup and interface generation. Generated MCP results are returned to the caller only; they are not saved or published.
https://gravity-ai.ydb-qdrant.tech/mcpcodex mcp add gravityAiUi --url https://gravity-ai.ydb-qdrant.tech/mcpsearch_interfacesget_interfacegenerate_interfacerefine_interfaceAPI behavior for agents
Rate limits
The public demo is for low-volume interactive use. Agents should back off on transient failures and respect RateLimit-* or Retry-After headers when present.
Errors
Handled API and discovery routes return structured JSON with error.code, error.message, and docs links where useful.
Idempotency
Mutation endpoints document Idempotency-Key for agent retry planning. Durable idempotency is not enforced in this metadata-only pass.
Local verification commands
Baseline commands for local development and verification.
npm run dev -- --port 3000npm run lintnpm testnpm run typechecknpm run buildAsk AI about Gravity AI UI
Open an AI assistant with a product evaluation prompt.