# Describe the feature to Leap. Bird delivers the messages.

Point Leap at a Bird guide and describe what your app should send. Leap writes an Encore endpoint with the Bird SDK, and your API key lives in a Leap secret.

[Get Started](/dashboard/signup)

[Contact Sales](/demo)

## From prompt to delivered.

Your agent can set up channels, manage customers, and confirm delivery. Full read and write access through MCP and CLI.

**MCP**: `https://mcp.bird.com`

```json
{
  "name": "voice_legs_list"
}
```

Examples: [MCP](/ai/leap.mcp.md) · [CLI](/ai/leap.cli.md) · [TypeScript](/ai/leap.ts.md) · [Python](/ai/leap.py.md) · [Go](/ai/leap.go.md) · [PHP](/ai/leap.php.md) · [HTTP](/ai/leap.http.md)

## Add Bird to Leap. Then get to work.

Leap writes the integration from a prompt. You add the API key.

Prompt for Leap

```
Add a backend endpoint to send email with Bird. Follow https://bird.com/docs/get-started/send-your-first-email: use the @messagebird/sdk package and read the API key from a secret named BirdApiKey.
```

-

### Ask Leap

Paste the prompt into Leap’s chat. Leap reads Bird’s quickstart, writes the endpoint with the Bird SDK, and declares the BirdApiKey secret.

-

### Set the secret

Create an API key in Bird under Developers, then API keys. In Leap, open Settings, then Secrets, and paste the key as the BirdApiKey value. The Missing secret value notice in the chat opens the same screen.

-

### Send a test

Call the endpoint Leap created. The quickstart sends from onboarding@messagebird.dev to delivered@messagebird.dev, a sandbox address where each message delivers. Verify your own domain before you send to customers.

[Read the quickstart](/docs/get-started/send-your-first-email)

## Built with an agent. Ready for your users.

Your published app needs its own server-side connection to Bird.

### Keep the key on the server

Leap encrypts the BirdApiKey value and passes the secret to your backend at runtime. Your frontend calls your backend, and your backend calls Bird.

[Explore the API](/docs/api)

### Use a sender you control

Verify your email domain or configure an eligible sender for the channel you choose.

[Prepare your first send](/docs)

### Show the real result

Save the message ID. Update your app from the message status or delivery events.

[Follow the result](/docs/guides/webhooks)

## A few good places to start.

Name the Bird product and the secret. Leap writes the backend code.

Send a welcome email

```
When a user signs up, send a welcome email with Bird using the @messagebird/sdk package and the BirdApiKey secret. Store the returned message ID with the user.
```

Text an order update

```
When an order ships, send the customer an SMS with Bird, including the tracking link. Use the @messagebird/sdk package and the BirdApiKey secret.
```

Track delivery

```
Add an endpoint to read a Bird email message by its stored ID and return its status, so the order page shows whether the email was delivered.
```

## Before your first task.

The details behind a working connection.

How does Leap learn the Bird API?

From your prompt. Link a Bird guide, such as the email quickstart, and Leap reads the page before writing the endpoint.

Where does the API key live?

In a Leap secret. Leap encrypts the value and exposes the secret to your app at runtime, so the key stays out of your code.

Do I set a region?

No. The Bird SDK reads the region from your API key, so a key starting bk_eu1_ calls the EU host with no extra setup.

## Keep building. Everything connects.

Take the next step with the tools and guides for your project.

- [Email quickstart](/docs/get-started/send-your-first-email) — Create a key and send your first email.

- [SDK quickstarts](/docs/get-started/quickstarts) — Install and call Bird in each language.

- [Other AI tools](/ai) — Use the same workspace from another tool.



## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [Set up your coding agent](/docs/ai/set-up-your-agent) (docs)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)