---
title: "Use Shorebird from Claude and other AI apps"
description: "Connect the Shorebird MCP server to Claude, Claude Code, Codex or Antigravity and ask about your apps, releases, patches, active devices and plan usage."
---

Shorebird has an [MCP](https://modelcontextprotocol.io) server, so an AI app you already use can read your apps, releases and patches and answer questions about them in plain words.

The server’s URL is:

```
https://mcp.shorebird.dev/mcp
```

You sign in with your Shorebird account when you connect. There is no API key to create and nothing to install.

It only reads. It can’t publish, roll back or delete anything, and it sees only what your account can see in the [console](https://console.shorebird.dev).

## Questions you can ask

* How many devices used our app in the last four weeks, and how many were new?
* How do iOS and Android compare?
* What share of our users are on the latest release? Which old versions are still out there?
* How fast did yesterday’s patch roll out?
* How many releases did we ship this quarter, and how many patches did each need?
* What was in patch 4?
* Have we rolled back any patches on the latest release?
* How close are we to our plan’s patch install limit?

It can put answers together too: “Write a one-paragraph update on this app for the weekly team meeting.”

If your crash reports carry the patch number ([Sentry](/code-push/crash-reporting/sentry/), [Crashlytics](/code-push/crash-reporting/crashlytics/)), connect that tool’s MCP server as well and ask whether a patch made crashes better or worse.

## Connect

### Claude

In Claude on the web or desktop, open **Settings** > **Connectors**, choose **Add custom connector**, and enter the URL above. Choose **Connect** and sign in with Shorebird.

On a Team or Enterprise plan, an owner adds the connector for the organization first; then each person connects it and signs in.

### Claude Code

```
claude mcp add --transport http shorebird https://mcp.shorebird.dev/mcp
```

Then run `/mcp` in Claude Code, pick `shorebird` and sign in.

### Codex

```
codex mcp add shorebird --url https://mcp.shorebird.dev/mcp
codex mcp login shorebird
```

### Google Antigravity

Open **Manage MCP Servers**, choose **View raw config**, and add:

```
{
  "mcpServers": {
    "shorebird": {
      "serverUrl": "https://mcp.shorebird.dev/mcp"
    }
  }
}
```

### Other AI apps

Other apps that support remote MCP servers with OAuth sign-in may not be able to connect yet. If Shorebird’s sign-in page says the app isn’t approved for Shorebird yet, sign in there to ask for it. Shorebird is notified, and you can connect once it’s approved. If the app stops before showing a Shorebird sign-in page, ask for it on [Discord](https://discord.gg/shorebird) or [GitHub](https://github.com/shorebirdtech/shorebird/issues).

## What it can see

When you sign in, Shorebird asks you to let the app see your apps, releases, patches and how they’re used. The app gets the same view of your organizations and apps that you have in the console, and nothing it asks for can change them.

Its tools:

| Tool                       | What it reads                                                        |
| -------------------------- | -------------------------------------------------------------------- |
| `list_apps`                | Your apps, their latest release and patch, and their platforms       |
| `get_app`                  | One app                                                              |
| `list_releases`            | An app’s releases: version, platforms, Flutter version, date, notes  |
| `list_patches`             | A release’s patches: number, channel, date, rollback, notes, size    |
| `get_version_distribution` | Which release versions active devices are on                         |
| `get_patch_adoption`       | How far each patch on a release has reached                          |
| `get_active_devices`       | Active and new devices over a period, by platform or release version |
| `get_usage`                | Patch installs this billing period against your plan, and per app    |

To disconnect, remove Shorebird from the app’s connector or MCP settings.

To ask for a question it can’t answer yet, write on [Discord](https://discord.gg/shorebird) or [GitHub](https://github.com/shorebirdtech/shorebird/issues).