Kleap

Kleap — website infrastructure for AI agents

Your agent builds. Kleap ships it live.

Let any AI agent — Claude, ChatGPT, Cursor, or a bash-tool agent like Claude

Code — build, edit and publish real, live websites for you. Hosting,

database, auth and domains included.

An alternative to Lovable / v0 / Bolt — except it's driven by your agent, and every publish comes with the verified-live guarantee: a site is only ever reported online once it is *provably serving* — never a hallucinated dead link.

This package is both a CLI (kleap create "…", kleap publish 42, …) and an MCP server (kleap mcp / no args) — same account, same ~/.kleap/config.json auth, same underlying /api/v1 REST API. Pick whichever fits your agent: a shell/bash-tool agent (Claude Code, a cron script, CI) wants the CLI — one compact line per call, no JSON-RPC framing. An MCP-native client (Claude Desktop, Cursor, ChatGPT connectors) wants the MCP server, which this package also is, unchanged.

*Above: a real run — your agent writes the code with write_files, publish_app builds & deploys it, and the page is live in seconds. Or just ask Kleap's AI in plain English.*

No secrets live in this package — it reads your own KLEAP_API_KEY (or the token saved by kleap auth login) and talks only to kleap.co.

---

CLI (for agent shells — Claude Code, Codex, scripts)

If your agent drives a bash tool rather than MCP, use the CLI directly. Output is 1-3 lines by default (token-efficient — built for an agent reading its own tool output, not a human terminal), clean exit codes (0 ok / 1 failed / 2 still running), and a --json flag whenever you want the full structured response.

npx -y kleap-cli auth login              # opens your browser once, no key to paste

— or, for CI / non-interactive: npx -y kleap-cli auth key kleap_live_sk_...

npx -y kleap-cli create "a one-page site for my bakery, warm palette"

✓ created app 4821 — https://warm-bakery-fold.kleap.io

npx -y kleap-cli edit 4821 "change the headline to 'Roasted slow'"

✓ edited app 4821 — https://warm-bakery-fold.kleap.io

npx -y kleap-cli publish 4821

✓ published https://warm-bakery-fold.kleap.io

npx -y kleap-cli status warm-bakery-fold.kleap.io # by id, slug, kleap.io URL, or connected custom domain

✓ Bakery (4821) — live: https://warm-bakery-fold.kleap.io

Commands

accepts a numeric app id, a slug.kleap.io URL, a bare slug, or a connected custom domain — resolved server-side in one call (GET /apps/resolve), same as the MCP find_app tool.

Example: a Claude Code / bash-tool agent

# One-shot: build it, publish it, hand back a URL a human can click.

url=$(npx -y kleap-cli create "a landing page for my podcast" --json | node -e \ 'let d="";process.stdin.on("data",c=>d+=c).on("end",()=>console.log(JSON.parse(d).url))') echo "Live: $url"

Non-blocking flow (agent does other work while it builds):

npx -y kleap-cli create "a landing page for my podcast" --no-wait --json # → { task_id, app_id, ... }

... later ...

npx -y kleap-cli status 4821

Exit codes are always clean: 0 on success, 1 on any failure, 2 when a build is still running after the wait cap (9 min, KLEAP_WAIT_MINUTES to change it) — not a failure: the line gives the kleap task --wait to keep waiting. Failures print a single ✗ line on stderr (or {"error":{"message":...}} with --json) — safe to check with $? / try/except subprocess.run(..., check=True) without scraping prose.

Install once (optional — npx -y above needs no install)

npm i -g kleap-cli

kleap auth login kleap create "a one-page site for my bakery"

---

MCP server (for MCP-native clients — Claude Desktop, Cursor, ChatGPT)

Same package, same account, same ~/.kleap/config.json auth — just a different transport for clients that speak MCP instead of a bash tool.

Easiest — connect with OAuth, no key

Add the hosted connector and sign in. Nothing to generate, nothing to paste — you authorize Kleap in your browser like any other app. Works in Claude Desktop, ChatGPT and Cursor.

https://kleap.co/api/mcp

• Claude Desktop — Settings → Connectors → Add custom connector → paste the URL → Connect → sign in to Kleap.
• ChatGPT — Settings → Connectors → add the URL → authorize with OAuth.
• Cursor — Settings → MCP → Add server → paste the URL → authorize.

That's it — all 34 hosted tools (the 33 listed below plus upgrade_plan) are available after OAuth sign-in. Skip straight to step 3.

---

Or — local CLI, sign in with your browser (no key)

Prefer a local stdio process? Sign in once — no key to generate or paste:

npx kleap-cli auth login

This opens your browser, you authorize Kleap, and the token is saved to ~/.kleap/config.json. After that, npx -y kleap-cli just works. (kleap auth logout / kleap auth status are there too.) Then add a keyless stdio entry to your client, e.g. Claude Desktop claude_desktop_config.json:

{ "mcpServers": { "kleap": { "command": "npx", "args": ["-y", "kleap"] } } }

---

Or — local CLI with an API key

Prefer a key (e.g. for CI or scripting the REST API directly)?

1. Get an API key — open kleap.co/settings/api-key and click Create my API key (kleap_live_sk_...).

2. Add Kleap to your AI client:

Claude Desktop — claude_desktop_config.json

{

"mcpServers": { "kleap": { "command": "npx", "args": ["-y", "kleap"], "env": { "KLEAP_API_KEY": "kleap_live_sk_..." } } } }

</details>

Cursor — .cursor/mcp.json

{

"mcpServers": { "kleap": { "command": "npx", "args": ["-y", "kleap"], "env": { "KLEAP_API_KEY": "kleap_live_sk_..." } } } }

</details>

Claude Code — one command

claude mcp add kleap -e KLEAP_API_KEY=kleap_live_sk_... -- npx -y kleap-cli

Cline / Roo (VS Code) — cline_mcp_settings.json

{

"mcpServers": { "kleap": { "command": "npx", "args": ["-y", "kleap"], "env": { "KLEAP_API_KEY": "kleap_live_sk_..." } } } }

</details>

Windsurf — ~/.codeium/windsurf/mcp_config.json

{

"mcpServers": { "kleap": { "command": "npx", "args": ["-y", "kleap"], "env": { "KLEAP_API_KEY": "kleap_live_sk_..." } } } }

</details>

ChatGPT & hosted agents — no local process

Add the hosted connector at `https://kleap.co/api/mcp` and authorize with OAuth (or paste your kleap_live_sk_ key). Same tools, no install.

Every stdio config is identical — npx -y kleap-cli + a KLEAP_API_KEY env var —

so any MCP client works.

Least-privilege keys: when you generate a key, pick a scope — Read-only (inspect sites, no changes), Build, or Full. Buying domains is never included by default. Give a read-only agent a read-only key.

3. Restart the client and just ask:

*"Build me a one-page site for my bakery, publish it, and give me the live URL."*

*"Add a contact form to my site and redeploy."*

*"Change the headline to 'Roasted slow' and publish."*

Works with any MCP-compatible agent: Claude · ChatGPT · Cursor · Claude Code · Codex.

---

Tools

Find & build — find_app · create_app · modify_app · check_task · retry_task · rename_app · get_screenshot · wake_app Files — list_app_files · read_files · write_files · edit_files · delete_files · generate_image Publish & domains —