# Antideploy MCP server

> Deploy and run applications directly from your coding agent without managing dashboards, Dockerfiles, or YAML configurations.

- Repository: https://github.com/antideploy/antideploy-mcp
- Page: https://hostedmcp.org/servers/antideploy/antideploy-mcp
- Transport: stdio
- Stars: 8
- License: MIT
- Latest version: 0.2.0

## Install

### Claude Code

```sh
claude mcp add --env 'ANTIDEPLOY_API_KEY=<YOUR_ANTIDEPLOY_API_KEY>' antideploy-mcp -- npx -y antideploy-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "antideploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "antideploy-mcp"
      ],
      "env": {
        "ANTIDEPLOY_API_KEY": "<YOUR_ANTIDEPLOY_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "antideploy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "antideploy-mcp"
      ],
      "env": {
        "ANTIDEPLOY_API_KEY": "<YOUR_ANTIDEPLOY_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"antideploy-mcp","type":"stdio","command":"npx","args":["-y","antideploy-mcp"],"env":{"ANTIDEPLOY_API_KEY":"<YOUR_ANTIDEPLOY_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "antideploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "antideploy-mcp"
      ],
      "env": {
        "ANTIDEPLOY_API_KEY": "<YOUR_ANTIDEPLOY_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add antideploy-mcp --env 'ANTIDEPLOY_API_KEY=<YOUR_ANTIDEPLOY_API_KEY>' -- npx -y antideploy-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.antideploy-mcp]
command = "npx"
args = ["-y", "antideploy-mcp"]

[mcp_servers.antideploy-mcp.env]
ANTIDEPLOY_API_KEY = "<YOUR_ANTIDEPLOY_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'ANTIDEPLOY_API_KEY=<YOUR_ANTIDEPLOY_API_KEY>' antideploy-mcp npx -- -y antideploy-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "antideploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "antideploy-mcp"
      ],
      "env": {
        "ANTIDEPLOY_API_KEY": "<YOUR_ANTIDEPLOY_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ANTIDEPLOY_API_KEY` | no | yes | Optional. A project key for one application, from the console, starting with ad_. Leave it out and use the login tool instead. |
| `ANTIDEPLOY_URL` | no | no | Base URL of the Antideploy instance. Defaults to https://antideploy.com. Only set for a self-hosted or staging instance. |

## Tools (48)

- `login`: Connect this machine to the user's Antideploy account. First call: returns a link and a short code; show both to the user, who opens the link, checks the code matches and clicks Approve (that is the only thing they do; if they have no account the same link creates one). Then call `login` again: it waits for the approval, saves the login in ~/.antideploy and tells you which account was connected, which you must tell the user. Later calls just confirm the connection. The login can be revoked any time at https://antideploy.com/tokens. If the user declines, stop and do not start another unless they ask. The token is never shown to you.
- `logout`: Delete the account token saved on this machine, only when the user asked to sign out. It does not revoke the token on the server; for that the user opens https://antideploy.com/tokens. A project key in ANTIDEPLOY_API_KEY is not affected.
- `list_applications`: Every application on the account (or the one this server's key belongs to), with its id, name and address, and which account this is. Use it to pick an id for `link_application`. (read-only)
- `create_application`: Create an Antideploy application for the project in this folder and record it in .antideploy.json, so every later call knows which application it is about. This is the step the dashboard used to be for: there is no application or key to make by hand. Do it once per project, before `database_create` and `deploy`. A name already in use answers with the existing application, which is then linked instead of duplicated and marked `reusedExisting`: that application may belong to another project, and a deploy replaces what is live there, so ask the user before deploying to it. The address is the user's to choose: if they have said what they want, pass it as `subdomain` after `check_address`; otherwise leave it out and settle it with `update_app_settings` before the first deploy. A 402 means the plan's limit is reached: that is not a rate limit, so do not retry, say what it says and let the user choose. Needs `login`.
- `link_application`: Record an application the user already has in .antideploy.json for this folder, so deploys and the other tools act on it. Take the id from `list_applications`. Only when the user said which one; never guess, because deploying a project over another application replaces what is live there.
- `check_address`: Check whether an address label such as my-app is free to use as my-app.antideploy.app, before creating the application with it. The address is the link the user shares, so it is theirs to choose. (read-only)
- `deploy`: Package a project directory and deploy it. Sends the whole directory, not just an entry point: a deploy containing one file builds successfully and then serves a page whose assets all 404. Returns a taskId to poll with `deployment_status`. A .env file is never uploaded, and neither are node_modules, build output, private keys or Python virtualenvs; the result names any .env files that were left out. The application's variables come from `set_env`, `set_env_from_file` or the `env` argument here, and the platform sets the database, storage, sign-in and email ones itself. The folder must be linked to an application (`create_application`) unless this server has a project key. When it succeeds, tell the user where it is live and on which account.
- `deployment_status`: Progress for one deployment: status, per-step detail, the analyzed spec, warnings and hazards. The call waits up to 20 seconds for the deploy to finish, so call it again straight away until the status is succeeded or failed; do not add pauses or your own polling loop. A first deploy usually takes one to three minutes. Once it is live, `summary` is the sentence to tell the user: the address and the account. On a failure read `error`, `failedStep` and the logs, fix the cause, and only then deploy again; an unchanged redeploy fails the same way. (read-only)
- `list_env`: Names only. The platform never returns values, by design. (read-only)
- `set_env`: Store or replace environment variables for this application. Write-only. Do not pass DATABASE_URL, PG*, storage, sign-in or email variables: the platform sets those itself. To take values from a local .env without them passing through this conversation, use `set_env_from_file`.
- `set_env_from_file`: Read the named variables out of a .env file in the project directory and store them for the application, so the values go from the file to Antideploy and never through this conversation. Only the names you list are sent. Names the platform fills in itself (the database, storage, sign-in and email variables, the application's own address and generated signing secrets) are refused with the reason, and so are empty values and template placeholders like your-key-here. The result names what was stored and what was skipped, never a value. Redeploy afterwards for the running app to pick them up.
- `request_keys`: For a value that is not in the project, such as a Stripe secret key, a bot token or an AI provider's key: get a link where the user pastes it on an Antideploy page, so it goes straight into the application's encrypted variables and never passes through this conversation. Show the user the `url`, say where they find the value in that provider's dashboard, then poll `list_env` until every name appears, and `redeploy`. Never ask the user to paste a key into the chat. Do not ask for what the platform fills in itself (the database, storage, sign-in and email variables, the application's own address and signing secrets).
- `api_info`: The platform's self-description: endpoints, limits and current behaviour. Worth reading whenever something here disagrees with what the server does. (read-only)
- `redeploy`: Build and release the application again without uploading it. By default that is the version last sent, with the current environment variables: this is how a changed variable or a new AI key reaches the running app. For an application built from GitHub, `latest` deploys the newest commit on its default branch instead. Returns a taskId to poll with `deployment_status`.
- `deployment_history`: Recent deploys, newest first: status, commit, address, and the full failure sentence in `error`. Read this before redeploying after a failure; an unchanged redeploy fails the same way. (read-only)
- `logs`: What the running container has printed, newest last. (read-only)
- `health`: Last observed state (healthy, degraded, down or unknown) and when it was checked. A sweep every five minutes, not a probe taken now: compare `checkedAt` with your deploy. (read-only)
- `metrics`: Requests, server errors and their rate, p50 and p95 response times, and requests per day. Check it when the user says the site is slow or failing: logs show what happened, this shows how often. Requests include bots and every asset on a page, so they are not visitors. (read-only)
- `rollback`: Put back the last version that went live before the one serving now, or a specific deployment from `deployment_history`. It is built again from its source, so it takes as long as a deploy; poll `deployment_status` with the returned taskId.
- `remove_env`: Remove one variable. The running app keeps it until the next deploy; `redeploy` applies it. A removed value cannot be shown again, only set again.
- `app_settings`: Its address, source, repository and branch, whether a push deploys it (`deployOnPush`), and its root directory. (read-only)
- `update_app_settings`: Change any of: the address (`subdomain`, which stops the old one working at once; ask the user first and show them the full URL), whether a push to a GitHub repository deploys by itself (`deployOnPush`), and which directory holds the application inside the project (`rootDirectory`, null for the whole project). Changing the directory analyzes the project again and reports what it found; the running app changes on the next deploy.
- `list_schedules`: The application's scheduled jobs, each with its next and last run, last status and error, plus the rules: UTC, a few jobs per application, runs at least five minutes apart. (read-only)
- `add_schedule`: Call a path on the application on a schedule, such as a nightly cleanup. Anyone can send the x-antideploy-cron header the call carries, so an endpoint that does real work should also check a secret of the app's own.
- `set_schedule_enabled`: Resuming also resets the job's failure count, which pauses it after ten in a row.
- `remove_schedule`: To change a job's schedule or path, remove it and add it again.
- `database_info`: Its state, size and tables, with the connection string masked. The platform creates a Postgres database and sets DATABASE_URL by itself when the project needs one, or earlier when `database_create` asks: do not send the user to sign up for another. (read-only)
- `database_create`: Create this application's Postgres database now, while the project is still being written, so it is built and tested against the real thing instead of SQLite or mock data. A later deploy reuses it, so what was tested is what goes live. Safe to call twice. Skip it when the project stores nothing, or already points at a database the user chose (a DATABASE_URL in .env that is not localhost, or a provider they named): the answer is a 409 own_database. It counts against the plan's allowance; a 402 database_limit is not a rate limit, so do not retry, say what it says and let the user choose. If the call is refused or blocked, do not look for another route: tell the user, who can approve it or press Create database on the application's page in the console, then carry on with `database_env_to_file`. The connection string is not returned: call `database_env_to_file` to put it in .env. Tell the user what was created and on which account.
- `database_env_to_file`: Write DATABASE_URL and the PG* variables for this application's database into a .env file in the project directory, and return only the names of what was written. The password goes into the file and never into this conversation, so do not read the file back out to the user. These are the same variables the deployed app receives. Variables already in the file are replaced, everything else is kept, and the file is added to .gitignore. Needs the account token that `login` (or https://antideploy.com/agent.md) saves on this machine: a project key cannot read a connection string. Once the app is live its database holds real data: do not reset, truncate or drop it from here without asking.
- `storage_create`: Create a private S3 bucket for this application now, while the project is still being written, so uploads are built and tested against real storage instead of the container's disk, which is wiped on every deploy. A later deploy gives the running app the same bucket. Safe to call twice. Only for a project that stores uploads or generated files: skip it otherwise, and skip it when the project already has a storage key of its own (an AWS_ACCESS_KEY_ID in .env that is not ours, or a service the user named, such as Cloudinary or UploadThing): the answer is a 409 own_storage. It counts against the plan's bucket allowance; a 402 storage_limit is not a rate limit, so do not retry, say what it says and let the user choose. If the call is refused or blocked, do not look for another route: tell the user. The key is not returned: call `storage_env_to_file` to put it in .env. Addressing is path style, which current AWS SDKs and boto3 choose by themselves for this bucket's name, so existing code that reads those variables works as it is; in new JavaScript code set forcePathStyle: true anyway. A browser can upload straight to the bucket with a presigned PUT URL. Tell the user what was created and on which account.
- `storage_env_to_file`: Write the bucket's name, endpoint, region and access key (AWS_S3_BUCKET, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ENDPOINT_URL_S3, AWS_REGION and the spellings other S3 libraries read) into a .env file in the project directory, and return only the names of what was written. The key goes into the file and never into this conversation, so do not read the file back out to the user. These are the same variables the deployed app receives, so do not copy them into `set_env`. Variables already in the file are replaced, everything else is kept, and the file is added to .gitignore. The bucket has to exist first: `storage_create` makes it. Needs the account token that `login` (or https://antideploy.com/agent.md) saves on this machine: a project key cannot read the access key.
- `auth_create`: Switch on sign-in (Neon Auth) for this application now, while the project is still being written, so a login page is built and tested against the real thing instead of a library and a table of passwords of your own. The people who sign up are rows in a neon_auth schema of the application's own Postgres, so it makes the database first if there is none, and that counts against the plan's databases. Safe to call twice. Only for a project that has accounts: skip it otherwise, and skip it when the user already chose a service (Clerk, Auth0, Supabase Auth), or when the project connects to a database of its own: the answers are 409 own_auth and own_database. A 402 database_limit is not a rate limit, so do not retry, say what it says and let the user choose. If the call is refused or blocked, do not look for another route: tell the user. The cookie secret is not returned: call `auth_env_to_file` to put the variables in .env. In Next.js, install @neondatabase/auth and follow https://neon.com/docs/auth/quick-start/nextjs (a beta library, so that page is the source of truth for its code). Anywhere else it is Better Auth over HTTP at NEON_AUTH_BASE_URL: POST /sign-up/email and /sign-in/email, GET /get-session, and GET /token for a JWT that verifies against NEON_AUTH_JWKS_URL, every request carrying an Origin that is the application's own address. Localhost works while you build, and the platform registers the application's address and any custom domain itself. Sign-up and sign-in allow about nine attempts per ten seconds, then answer 429, so show a person a try-again message. Tell the user what was created and on which account.
- `auth_env_to_file`: Write NEON_AUTH_BASE_URL, NEON_AUTH_COOKIE_SECRET, NEON_AUTH_JWKS_URL and VITE_NEON_AUTH_URL into a .env file in the project directory, and return only the names of what was written. The cookie secret goes into the file and never into this conversation, so do not read the file back out to the user. These are the same variables the deployed app receives, so do not copy them into `set_env`. Variables already in the file are replaced, everything else is kept, and the file is added to .gitignore. Sign-in has to exist first: `auth_create` makes it. Needs the account token that `login` (or https://antideploy.com/agent.md) saves on this machine: a project key cannot read the secret.
- `email_create`: Let this application send email now, while the project is still being written, so a welcome or a password reset is built and tested against the real thing instead of being left out or sending the user to open a Resend account and verify a domain. There is nothing to sign up for. Safe to call twice. Only for a project that sends mail: skip it otherwise, and skip it when the project already sets a RESEND_API_KEY of its own (409 own_email). A 503 email_unavailable means email is not set up on this server: carry on without it and tell the user. If the call is refused or blocked, do not look for another route: tell the user. The token is not returned: call `email_env_to_file` to put the variables in .env. Send with the `resend` package written as for any Resend account: new Resend(process.env.RESEND_API_KEY), then resend.emails.send({ from: process.env.EMAIL_FROM, to, subject, html }); in Python resend.api_key = os.environ['RESEND_API_KEY']. The package reads RESEND_BASE_URL or RESEND_API_URL, which point at the platform's relay. The message always leaves from the application's own address under the platform's sending domain, whatever `from` says, with the application's name as the display name, and nothing receives replies at that address, so set reply_to (replyTo in Node) to a real one if people may answer. It is transactional mail: at most five addresses on a message, a limited number a day by the owner's plan (fewer for an account only days old), and a 429 with daily_quota_exceeded or rate_limit_exceeded means try later, so show a person a message and do not retry in a loop. Attachments, scheduled sending, templates and resend.batch.send are refused. Never use it for newsletters or bulk mail. Tell the user what was set up and on which account.
- `email_env_to_file`: Write RESEND_API_KEY, RESEND_BASE_URL, RESEND_API_URL and EMAIL_FROM into a .env file in the project directory, and return only the names of what was written. RESEND_API_KEY here is a token for the platform's relay, not a Resend key, and it goes into the file and never into this conversation, so do not read the file back out to the user. These are the same variables the deployed app receives, so do not copy them into `set_env`. Variables already in the file are replaced, everything else is kept, and the file is added to .gitignore. Email has to be set up first: `email_create` does it. Needs the account token that `login` (or https://antideploy.com/agent.md) saves on this machine: a project key cannot read the token.
- `email_status`: Whether this application can send email, from which address, its allowance and what it has sent in the last 24 hours, who stopped it if it is stopped (pausedBy, pausedReason), the last 14 days, when it last sent and how its mail is landing (`health`). Read it before telling the user whether email works. Never returns the token. (read-only)
- `email_activity`: The relay's log for this application, newest first: when, how many addresses, whether it was handed to Resend or turned away, and what Resend reported afterwards (delivered, bounced, complained, delayed, failed, suppressed) with a reason. Use it to answer "did my email go out" and "why did that one not arrive". It never has a subject, a body or an address, because none is kept. `outcome` is null until Resend has reported, and always while `reporting` is false. Page with `before` set to the `next` of the last answer. (read-only)
- `email_deliverability`: The last 7 days of this application's mail: delivered, bounced and reported as spam, whether it is healthy or one to watch, the recent problems with the reason Resend gave, and the rules the platform uses to stop an application's email by itself (at least three addresses bouncing that are a fifth of a day's mail, or two spam reports in a week). While `reporting` is false the counts are zero because Resend's reports are not connected: that means unknown, not healthy. (read-only)
- `email_domain`: The platform's sending domain, this application's own address under it, and the From value. Sending from the user's own domain is not offered, so never send the user to add DNS records for email. (read-only)
- `email_overview`: Every application on the account and where its email stands (state, who paused it, what it sent in the last day against its allowance, how its mail is landing), and which have none. Uses the account token when this machine has one; with only a project key it shows this application alone. (read-only)
- `email_pause`: Stop this application's email at once, for a leaked token or a loop in the code. Its token is refused (403 suspended_api_key) until `email_resume`. The application itself keeps running. Needs the account token that `login` (or https://antideploy.com/agent.md) saves: a project key cannot do it. Tell the user it is paused.
- `email_resume`: Start this application's email again after `email_pause`. A pause the platform made because the mail was bouncing or reported as spam answers 409 paused_for_deliverability and is not lifted from here: tell the user, who replies to the notice they were emailed. Do not remove email and set it up again to get round it. Needs the account token.
- `email_test`: Send one real message to the address of the account that owns this application, through the relay exactly as the application's code would, so the user can see that email works. The recipient is always the account's own address. It counts as one address against the day. Needs the account token.
- `email_remove`: Take email away from this application. Its token is refused from then on, and the running app keeps the variables it was given, so its mail fails until `email_create` sets it up again. Only when the user asked for it. Refused with 409 while the platform has it paused. Needs the account token.
- `security_scan`: Start a scan of the running application: keys shipped to the browser, endpoints open without a login, SQL injection, downloadable config files, open CORS and missing headers. Takes seconds. Poll `security_scan_status` with the returned scanId.
- `security_scan_status`: Status and findings, each with a severity, a plain explanation and a `recommendation`. Poll until completed or failed. Fix each finding at its root, then scan again. (read-only)
- `ai_wallet`: The balance, the rate usage is charged at, and the AI keys on this account. Only the user can add money: give them the `topUpUrl` and wait. (read-only)
- `create_ai_key`: Create an OpenRouter key (hundreds of models, any OpenAI-compatible client at https://openrouter.ai/api/v1) and save it into the application as OPENROUTER_API_KEY. Then `redeploy` so the running app picks it up. The secret is not returned here: it is in the application's environment, which is where it belongs, and out of this transcript. A key on an empty wallet is disabled until the user tops it up.

## FAQ

### Do I need to provide a Dockerfile or use a dashboard?

No, Antideploy is designed to work without a dashboard, Dockerfile, YAML, or even a GitHub repository.

### How are my secrets and environment variables handled?

Tokens and passwords never enter the conversation. Tools write variables directly into a .env file within your project and add it to .gitignore automatically.
