AppDeploy MCP Server

AppDeploy is an MCP server that deploys web apps to public URLs and provides the required runtime services in one platform: frontend and backend hosting, database access, file storage, and deployment management.

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 (Recommended)

Visit your platform's App Directory:
- ChatGPT: chatgpt.com/apps
- Claude: claude.ai/connectors
Find and connect to AppDeploy
Complete OAuth authentication when prompted

Manual Setup

Cursor

One-click install: Install in Cursor

Codex

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

Claude Code

claude mcp add --transport http AppDeploy https://api-v2.appdeploy.ai/mcp

Claude Desktop / Web

Go to Claude Settings → Connectors → Add custom connector

Name: AppDeploy
URL: https://api-v2.appdeploy.ai/mcp

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

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