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.

  1. 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"
        }
      }
    }
  2. 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.

  3. 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_TOKEN

15 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_shaders

    List shader wallpapers visible to your plan, optionally by category.

  • resolve_shader

    Turn a free-text request into exactly one shader id, or ask to disambiguate.

  • get_shader

    Full Metal source + SwiftUI snippet (xcode), or a short-lived AGSL zip ticket (android).

  • customize_shader

    Recolor or retime a shader with bounded, deterministic edits.

Icons

Tabler, Lucide, Hugeicons, line-md

  • list_icons

    List icons, ranked by tags when you pass a query.

  • resolve_icon

    Turn an intent into ranked, Free-first icon candidates.

  • get_icon

    One icon card: provider, tier, style, swiftRef and tags.

  • customize_icon

    Export with your stroke and color as SVG, JSX or TSX.

Compositions

iPhone (SwiftUI/Xcode) and Android (Jetpack Compose)

  • list_compositions

    List compositions visible to your plan. Only when you ask about apps.

  • resolve_composition

    Turn free text into one composition id, never guessing on a tie.

  • get_composition_download

    Issue a short-lived project zip URL, artifact xcode or android.

  • get_composition_design_brief

    Layout, screens and focus slots. No Swift or Kotlin sources.

Session

Search, playbook and errors

  • search_catalog

    Search shaders, icons or compositions by free text.

  • get_host_playbook

    The ZOREVA-UI host playbook, read once per session.

  • explain_last_error

    Explain an {error} payload and what to do next.

How it works

From prompt to project

  1. 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.

  2. 02

    Fetch

    Shaders and icons come back as code. Compositions come as a short-lived project zip from get_composition_download.

  3. 03

    Adapt

    Your agent unzips the project, reads it and adapts what you asked. A shader is never merged into an app automatically.