Docs

Everything here is written so a non-technical founder can follow it. If you can copy and paste, you can ship an app.

What is Debut?Connect your agentShip your first appWeb app → mobile appPrompts that workWhat Debut can doIs my code safe?CreditsTroubleshooting

What is Debut?

Agent Debut is a co-worker for the app-store part of your app. Your coding agent (Claude, Cursor, Codex…) writes the code. Debut does everything Apple and Google make you do afterward: builds, signing, screenshots, listings, in-app purchases, review, and rejections.

You never learn App Store Connect. You just tell your agent what you want — "put this on TestFlight", "submit version 1.2" — and the agent hands the work to Debut.

Non-technical? That's fine. The app has a guided, step-by-step connect flow that does everything below for you with buttons instead of a terminal.

Connect your agent (5 minutes)

Debut speaks MCP (Model Context Protocol) — the standard way agents connect to outside tools. You connect once; after that your agent can see and use Debut in every conversation.

The universal way, which works with 20+ agents:

npx add-mcp https://api.agentdebut.app/mcp

Or pick your agent:

Claude Code

Open your terminal in any project and run:

claude mcp add --transport http debut https://api.agentdebut.app/mcp

Then start Claude Code and type "list my apps with debut" to confirm it's connected.

Claude Desktop & claude.ai
  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Name it Debut and paste https://api.agentdebut.app/mcp.
  4. Click Add, then approve the connection when asked.
Cursor

Create (or open) the file .cursor/mcp.json in your project and add:

{
  "mcpServers": {
    "debut": { "url": "https://api.agentdebut.app/mcp" }
  }
}

Restart Cursor. Debut appears under Settings → MCP.

Codex (OpenAI)

Add this to ~/.codex/config.toml:

[mcp_servers.debut]
url = "https://api.agentdebut.app/mcp"
VS Code + Copilot Chat

Run this in a terminal:

code --add-mcp '{"name":"debut","url":"https://api.agentdebut.app/mcp"}'

Or add the same server in Settings → MCP Servers.

Something else (Replit, Cline, Windsurf, …)

Any MCP-capable agent works. Look for "MCP servers" in its settings and paste https://api.agentdebut.app/mcp, or use the universal command at the top of this section.

Then connect your accounts

  1. App Store Connect — sign in once in the Debut app; this unlocks your 500 free credits. (No Apple account yet? Debut walks you through creating one — $99/yr from Apple.)
  2. Google Play (optional) — connect your Play Console the same way ($25 one-time from Google).
  3. GitHub (optional) — needed only for web→mobile conversion and builds from source.

Ship your first app

Once connected, shipping is a conversation. A typical first run:

  1. Say what you want. In your agent, type: "Use Debut to ship this app to TestFlight."
  2. Debut builds and uploads. It clones your repo, builds, signs, and uploads. First time usually takes ~15 minutes.
  3. Check status anytime. Ask "what's the status of my build?" — Debut answers with the live state from Apple.
  4. Go to the store. Say "submit it for review". Debut creates the version, attaches the build, fills the metadata, and submits.
  5. If Apple rejects it — say "handle the rejection". Debut reads Apple's feedback, explains it in plain English, fixes what it can, and resubmits.

Web app → mobile app

Built your app on Lovable, Emergent, Bolt, Replit, or v0? Debut turns it into a real iOS and Android app.

  1. Connect GitHub. Your builder already pushes your code to a GitHub repo — connect it to Debut.
  2. Debut analyzes. It detects your framework and scans for the things Apple and Google reject: web checkout (must become in-app purchases), missing account deletion, missing privacy policy, and "it's just a website" risk.
  3. Debut refactors. It wraps your app in a native shell, adds the iOS and Android projects, and hands your coding agent a fix list for anything that needs real code changes.
  4. Ship both stores. Icons, splash screens, signed builds — TestFlight and Play Console.
One prompt to start: "Take github.com/me/my-app and get it ready for the App Store and Google Play."

Prompts that work

Paste any of these into your agent (or your no-code tool's chat) once Debut is connected:

• "Ship the current branch to TestFlight and tell me when it's processed."

• "Draft the App Store listing for 1.2 — name, subtitle, keywords, and what's new."

• "We got rejected. Read the resolution center, explain why, and fix it."

• "Convert my Lovable app at github.com/me/app into an iOS and Android app."

• "Check my app for anything Apple or Google would reject before I submit."

• "Set up a $4.99/month subscription called Pro in all territories."

What Debut can do

These are the tools your agent sees. You never call them yourself — your agent picks the right one from your plain-English request.

ToolIn plain English
list_apps"What apps do I have?"
get_app_status"What's the state of my builds and review?"
stage_buildBuild, sign, and upload to TestFlight
create_app_store_versionStart a new release (e.g. 1.2.0)
submit_for_reviewSend the release to Apple
import_repoPull in your GitHub repo (Lovable, Bolt, …)
analyze_web_appFigure out what kind of web app it is
store_readiness_checkFind anything the stores would reject
mobilize_web_appWrap the web app into iOS + Android projects
build_appCompile the app for iPhone or Android — errors come back explained
read_build_log"Why did the build fail?"
run_in_simulator"Show me my app running on an iPhone"
simulator_screenshotSnap the simulator screen — great for store screenshots
list_simulatorsWhich iPhones are available to test on
restore_snapshotUndo everything Debut changed, one command
asc_requestAnything else on App Store Connect (IAP, pricing, …)

Is my code safe?

Yes — Debut is built so it can move fast without being able to hurt your project.

  • Its own copy. Debut works in a cloned workspace; your original repo is never edited in place.
  • Its own branch. Every change lands on a debut/workbench branch — never your main branch.
  • Snapshot first. Before touching anything, Debut saves a snapshot of your project. Say "undo Debut's changes" and everything rolls back in one step.
  • Asks before the point of no return. Irreversible actions — like submitting to Apple review — never happen without your explicit yes.

Credits

Credits are what Debut spends when it works — a build costs more than a status check. You get 500 free credits for your first 30 days when you connect App Store Connect. Pro ($29.99/mo) includes 2,500 credits every month, and optional auto top-ups add 2,000 credits for $15 with a monthly cap you control. Nothing ever stops mid-task. Details on the pricing page.

Troubleshooting

My agent doesn't see Debut

Restart the agent after adding the server — most only load MCP connections on startup. Then ask it to "list debut's tools".

"Missing App Store Connect credentials"

You haven't connected your Apple account yet. Open the Debut app and finish the App Store Connect step, or set your API key if you're self-hosting.

The build failed

Ask your agent: "show me debut's build error and fix it." That's the whole workflow — the agent reads the log, changes the code, and re-runs the build.

Anything else

Email support@agentdebut.app — Pro gets priority.