AppDeploy MCP Server

AppDeploy is a chat-native deployment platform - deploy web apps directly from ChatGPT, Claude, Cursor, or Codex and get a live, public URL. No Git, no CLI, no IDE required.

Key capabilities:

  • Deploy frontend-only and fullstack apps with public URLs
  • Built-in hosting, database access, file storage, and deployment management
  • Track deployment status, runtime errors, and QA snapshots
  • Manage versions and roll back to prior versions
  • Inspect deployed source snapshots

Quick Start

App Directory (once the app is available)

  1. Visit your platform's App Directory:
  2. Find and connect to AppDeploy
  3. Complete OAuth authentication when prompted

Manual Setup

Claude (Web / Desktop)

Go to Settings → Connectors → Add custom connector

Name:

AppDeploy

ChatGPT

Go to Settings → Apps → Advanced settings → Enable Developer mode → Create app

Name:

AppDeploy

Codex

Run in terminal:

codex mcp add AppDeploy --url https://api-v2.appdeploy.ai/mcp

Cursor

One-click install: Install in Cursor

Authentication

This server supports OAuth authentication:

  • Sign in with Google
  • Sign in with Apple
  • Continue as Guest

All options provide full access to all tools and features. Sign-in with Google or Apple provides a consistent identity across platforms.

MCP Flow

  • Call get_deploy_instructions to fetch deployment constraints.
  • If the app needs persistence or server-side logic, call get_app_template.
  • Build the app and call deploy_app.
  • Poll get_app_status until the deployment reaches ready or failed.
  • If needed, inspect the deployed snapshot with src_glob, src_grep, and src_read.
  • Use get_app_versions and apply_app_version to roll back to a prior version.
  • Use delete_app only on explicit user request.

Tools

get_deploy_instructions

Returns deployment guidelines and required file rules.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

get_app_template

Templates reference for frontend and backend apps.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

deploy_app

Creates or updates an app deployment.

Annotations
  • readOnlyHint: false
  • idempotentHint: false
  • destructiveHint: true
  • openWorldHint: true

get_app_status

Returns deployment state, QA snapshot, and live error logs.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

get_app_versions

Lists deployable versions for an app.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

apply_app_version

Re-deploys an existing app at a specific version.

Annotations
  • readOnlyHint: false
  • idempotentHint: true
  • destructiveHint: true
  • openWorldHint: true

delete_app

Permanently deletes an app. Use only on explicit user request.

Annotations
  • readOnlyHint: false
  • idempotentHint: false
  • destructiveHint: true
  • openWorldHint: true

src_glob

Lists files in the deployed snapshot.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

src_grep

Searches deployed snapshot contents.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

src_read

Reads a file from the deployed snapshot.

Annotations
  • readOnlyHint: true
  • idempotentHint: true
  • destructiveHint: false
  • openWorldHint: false

What You Can Build

Copy-paste these prompts to your AI assistant to deploy working apps.

Static Site

Create a tribute page for Richard Feynman. Include his portrait image, a brief biography, his Nobel Prize work in quantum electrodynamics, and a section highlighting his key contributions to physics. Add links to his famous lectures and books.

Frontend App

Build a Pomodoro timer app with 25-minute work sessions and 5-minute breaks. Include start, pause, and reset buttons. Play a notification sound when the timer ends. Show the current session count.

Multiplayer Game

Create a two-player Tic-Tac-Toe game. Players alternate between X and O. Highlight the winning combination when someone wins. Show whose turn it is and include a reset button to start a new game.

File Upload App

Build an image gallery app where I can upload images, view them in a grid, click to see them full-size in a modal, and delete images I no longer want.

See more examples in the gallery.

Limits

AppDeploy currently operates under a fair use policy. Concrete limits will be introduced in the future.

Troubleshooting

  • Can’t connect? Verify the MCP URL is correct: https://api-v2.appdeploy.ai/mcp
  • Connected but tools don’t work? Confirm you’re authenticated. Disconnect and reconnect to refresh the authentication token.
  • Deployment stuck in deploying? Check status again after a short wait. Large apps can take a minute or two.
  • App shows a blank page? Ask your AI assistant to check for deployment errors and runtime errors.
  • App doesn’t work properly? Describe the exact behavior and have your AI assistant call get_app_status to check for errors.

Changelog

Version history and release notes are available on the changelog page.

Support

Email: support@appdeploy.ai