# GradientArt

> Generate editable CSS artwork and open it in the editor as an unsaved project.
> Every API handoff uses a temporary bearer token, expires after one hour, and
> requires an explicit user Save to become a permanent project.

## Agent workflow

- [Remote MCP connection guide](https://gra.dient.art/agents/mcp.md): Anonymous Streamable HTTP at https://gra.dient.art/api/mcp with one prepare_design tool; plugin connection and error handling.
- [Use with AI](https://gra.dient.art/docs/use-with-ai): Copyable prompt for web and local agents, file fallback, and integration setup.
- [ChatGPT GPT setup kit](https://gra.dient.art/agents/chatgpt-setup.md): Operator instructions and a preparation-only Action; publication requires an eligible account.
- [Design authoring and API guide](https://gra.dient.art/agents/designs.md): Start here; generation rules, examples, errors, expiry, and retention.
- [OpenAPI 3.1](https://gra.dient.art/openapi.json): Anonymous prepare and resolve operations.
- [Modular v1 entry schema](https://gra.dient.art/schemas/v1/project.schema.json): Small entry point with references to feature schemas.
- [Self-contained v1 schema](https://gra.dient.art/schemas/gradient-art-v1.schema.json): Offline validation without fetching references.

## Complete example documents

- [Minimal gradient](https://gra.dient.art/examples/minimal.gradient-art.json)
- [Clones, variables, and formulas](https://gra.dient.art/examples/clones-and-variables.gradient-art.json)

## Schema modules

- [Document](https://gra.dient.art/schemas/v1/document.schema.json)
- [Layer](https://gra.dient.art/schemas/v1/layer.schema.json)
- [Variables](https://gra.dient.art/schemas/v1/variables.schema.json)
- [Folder](https://gra.dient.art/schemas/v1/folder.schema.json)
- [Clone](https://gra.dient.art/schemas/v1/clone.schema.json)
- [Shared definitions](https://gra.dient.art/schemas/v1/common.schema.json)

Read the artwork schemas referenced by Layer only for the types your design uses.
The API validates semantic relationships as well as JSON structure; schema
validation alone cannot detect every invalid clone graph or formula.