VULK is callable

OpenAPI 3.1 spec

Every public endpoint is described in a machine-readable spec at https://vulk.dev/openapi.json. Drop the URL into Claude Desktop, Cursor, ChatGPT custom GPT, or any tool that imports OpenAPI — the agent gets typed tools for every operation, with descriptions, request shapes, and error codes.

Base URL: https://app.vulk.dev/api/v1

Generate a project from curl

curl -X POST https://app.vulk.dev/api/v1/projects \
  -H "Authorization: Bearer vk_$YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "Build a SaaS dashboard with auth + Stripe + Postgres" }'

# → 201 Created
# {
#   "project": {
#     "id": "8c1a2b3d-...",
#     "prompt": "Build a SaaS dashboard with auth + Stripe + Postgres",
#     "createdAt": "2026-05-08T..."
#   }
# }

Generation runs asynchronously. Poll GET /projects/{id} for status, or fetch the source tree via GET /projects/{id}/files once ready.

Claude Desktop, Cursor, Windsurf

For native tool-calling without writing HTTP code, install the VULK MCP server. The MCP client auto-exposes vulk_generate, vulk_export, and vulk_deploy as native tools.

{
  "mcpServers": {
    "vulk": {
      "command": "npx",
      "args": ["vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_your_key_here"
      }
    }
  }
}

Drop into ~/Library/Application Support/Claude/claude_desktop_config.json (Claude Desktop) or ~/.cursor/mcp.json (Cursor). See the vulk-mcp-server npm page for the full tool list.

Keys, rate limits, and credits

• Generate keys at app.vulk.dev/settings/api-keys. Each key is scoped to a single user account and starts with vk_. Revoke any time.
• Auth header: Authorization: Bearer vk_<key>. No query parameter, no cookie auth — Bearer only.
• Rate limits are enforced via the credit ledger, not a per-second quota. Each generation debits credits based on prompt complexity and model. Check GET /credits/balance before triggering a generation; you’ll get HTTP 402 if the user is out of credits.
• Errors: 401 = bad key, 402 = no credits, 404 = project not owned by this key, 400 = missing prompt.