MCP server · 15 tools
Connect your agent
The hosted ZOREVA-UI MCP server gives your coding agent Metal and AGSL shaders, icons, and composition project zips for iPhone and Android. Pick a client and add the server. Your client opens ZOREVA-UI, you sign in and press Allow, and it connects on its own.
MCP is free on every plan. Free accounts get 5 downloads a week of apps or shaders. See pricing
Setup
Pick your client
Cursor
Native MCP in Settings → MCP. Shaders and icons in the editor.
- 01
Add MCP server
Open or create ~/.cursor/mcp.json (or .cursor/mcp.json in a project) and paste this in:
json{ "mcpServers": { "zoreva-ui": { "url": "https://zoreva-ui.com/api/mcp", "type": "http" } } } - 02
Authenticate
Open Settings → MCP and press Connect (or Needs login) next to zoreva-ui. Your client opens zoreva-ui.com: sign in, check what it asks for and press Allow. The connection is saved automatically; there is nothing to copy.
- 03
Check it works
In Settings → MCP, zoreva-ui shows a green dot and its tools. Open a new Agent chat and ask: “List ZOREVA-UI shaders.” The agent should call list_shaders.
Manual token (fallback)
Only for clients that can't do OAuth sign-in. Open Account → Copy MCP access token, and send it as a header. Tokens from Account last 7 days.
Authorization: Bearer YOUR_ZOREVA_TOKEN15 tools
What your agent can call
Tools run only when you ask. Free and Pro limits and weekly quotas apply to every call.
Shaders
Metal + SwiftUI, or Android AGSL
list_shadersList shader wallpapers visible to your plan, optionally by category.
resolve_shaderTurn a free-text request into exactly one shader id, or ask to disambiguate.
get_shaderFull Metal source + SwiftUI snippet (xcode), or a short-lived AGSL zip ticket (android).
customize_shaderRecolor or retime a shader with bounded, deterministic edits.
Icons
Tabler, Lucide, Hugeicons, line-md
list_iconsList icons, ranked by tags when you pass a query.
resolve_iconTurn an intent into ranked, Free-first icon candidates.
get_iconOne icon card: provider, tier, style, swiftRef and tags.
customize_iconExport with your stroke and color as SVG, JSX or TSX.
Compositions
iPhone (SwiftUI/Xcode) and Android (Jetpack Compose)
list_compositionsList compositions visible to your plan. Only when you ask about apps.
resolve_compositionTurn free text into one composition id, never guessing on a tie.
get_composition_downloadIssue a short-lived project zip URL, artifact xcode or android.
get_composition_design_briefLayout, screens and focus slots. No Swift or Kotlin sources.
Session
Search, playbook and errors
search_catalogSearch shaders, icons or compositions by free text.
get_host_playbookThe ZOREVA-UI host playbook, read once per session.
explain_last_errorExplain an {error} payload and what to do next.
How it works
From prompt to project
- 01
Ask
Ask your agent for a shader, an icon or a composition. It resolves the request to one id, or asks you to choose.
- 02
Fetch
Shaders and icons come back as code. Compositions come as a short-lived project zip from get_composition_download.
- 03
Adapt
Your agent unzips the project, reads it and adapts what you asked. A shader is never merged into an app automatically.