Skip to content

MODEL CONTEXT PROTOCOL (MCP) SERVER

Ship Builds from Your AI Assistantwith the BetaDrop MCP Server

BetaDrop MCP connects Cursor, Claude, and Copilot to BetaDrop.Publish builds, track releases, and manage tokens using pure natural language.

AI Code Editor

BetaDrop MCP demo prompts:

Add the @betadrop/mcp server to my global mcp.json config

Log me in to BetaDrop with my API token

Publish ./build/MyApp.ipa to BetaDrop

Get the install link for the latest uploaded APK

Create a new scoped API token for CI/CD

Get started in 2 steps

From installation to your first AI-driven build publish in under 2 minutes.

1

Get a BetaDrop API Token

Sign up or log in at betadrop.app. Go to Settings → Developer → API tokens. Click Create Token, give it a name (e.g. "My IDE"), and copy the token.

The token starts with bd_live_ and is shown once. Store it in a password manager.
2

Add the MCP Server to Your Editor

Use your AI assistant to automatically install and configure the MCP server.

AI-assisted installation

You're already driving an AI assistant (Cursor Composer, Claude, Copilot, or Antigravity), so there's no config file to edit by hand. Paste one of these prompts into the chat:

Cursor
"Add the @betadrop/mcp server to my global Cursor mcp.json config"
Antigravity
"Add the @betadrop/mcp server to my Antigravity mcp_config.json"
VS Code (Copilot)
"Add the @betadrop/mcp server to my workspace .vscode/mcp.json"
Claude Desktop
"Add the @betadrop/mcp server to my Claude Desktop config"

The assistant locates, creates, or updates the config file for you. Restart or refresh your editor afterwards. MCP servers are discovered at startup.

Supported Environments

  • Editors: Cursor, VS Code (Copilot), Antigravity, Windsurf, Zed
  • Agents: Claude Code, Claude Desktop
  • Node: Requires Node 18+ for running via `npx`.

Publishing Builds

Use natural language to tell your AI assistant exactly what you want to do.

"Publish ./build/MyApp.ipa to BetaDrop"
Uploads the IPA and returns an install link
"Upload MyApp.apk with notes 'Fixed login crash on Android 14'"
Publishes with release notes visible to testers
"Push the latest IPA to BetaDrop, expire after 7 days"
Sets a time-based expiry on the build
"Upload MyApp.ipa and send me the install link"
Returns a shareable OTA install URL

Available MCP Tools

You don't call these by name. Describe the outcome and the assistant picks the tool. The full argument reference for all ten is in the MCP server docs.

betadrop_publish
Upload an iOS (.ipa) or Android (.apk) build and retrieve the install URL.
betadrop_list_builds
List recent builds published to BetaDrop, with filters for platform and expiry.
betadrop_list_expired_builds
Show a list of all expired builds with details on why they expired.
betadrop_login
Save and validate a BetaDrop API token into your global configuration.
betadrop_logout
Revoke your token server-side and clear local credentials.
betadrop_whoami
Check your authentication status and view your active token details.
betadrop_token_create
Generate a new scoped API token.
betadrop_token_list
List all active CLI/MCP tokens associated with your account.
betadrop_token_delete
Revoke a token by its id, as listed by betadrop_token_list.
betadrop_help
Built-in quick reference: the tool list, their inputs, and example prompts.

Frequently asked questions

How do I add the BetaDrop MCP server to Cursor?

Add a betadrop entry to Cursor's mcp.json — "command": "npx", "args": ["-y", "@betadrop/mcp"] — either in .cursor/mcp.json for one project or in the global config, then refresh Cursor, since MCP servers are discovered at startup. Nothing installs ahead of time: npx fetches the package on first run, and Node 18 or newer is the only requirement. You can also paste the install prompt from this page into Cursor's chat and let it edit the config for you.

Does the BetaDrop MCP server work with Claude Code?

Yes. One command registers it for every project: claude mcp add betadrop -s user -- npx -y @betadrop/mcp. Claude Desktop uses the same server through an mcpServers entry in its config file. In both cases the server is a local process speaking stdio to the client, and it shares credentials with the BetaDrop CLI, so a machine where betadrop login has already run is authenticated with nothing further to configure.

How does the MCP server authenticate with BetaDrop?

The MCP server resolves credentials exactly the way the CLI does: a BETADROP_TOKEN environment variable first, then the shared credentials file that betadrop login writes. If you have logged in with the CLI on the same machine there is nothing to set up. Otherwise, create a token under Settings → Developer → API tokens and ask the assistant to run betadrop_login with it — the token is validated against the server before it is saved, and saving it also logs the CLI in.

Does my app binary pass through the AI model when I publish?

No. The build never passes through the assistant or the model. The MCP server runs locally on your machine, reads the .ipa or .apk from disk, and uploads it directly to BetaDrop. What the assistant sees is the tool call and the result: build metadata and the install link. That is also why betadrop_publish takes an absolute file path — the server does not necessarily share a working directory with your editor.

Ship without leaving your editor

Stop context-switching. Stay in your code and let your AI assistant handle the distribution.

$npx -y @betadrop/mcp
Go to dashboard