# Build Base44 apps that send email, SMS, WhatsApp, and verification codes.

Connect Base44 to Bird while you build internal tools, customer portals, and business apps. Configure sending domains and channels from your workspace, keep live API credentials on the backend, and track delivery statuses as messages reach your users.

## From prompt to delivered.

Send messages and check delivery from your code, terminal, or AI assistant.

- MCP
- CLI
- Node.js
- Python
- Go
- PHP
- Serverless
- REST

### YouVoice

Can you check which calls are active right now and tell me which are connected and which are still ringing?

#### Bird MCP4 connected actions
1. **1** Read the workspace `workspace_get`
2. **2** Find calls in progress `voice_legs_list`
3. **3** Inspect the connected call `voice_legs_get`
4. **4** Inspect the ringing call `voice_legs_get`

### YouEmail

Send a welcome email to delivered@messagebird.dev from onboarding@messagebird.dev, then check it arrived.

#### Bird MCP3 connected actions
1. **1** Read the workspace `workspace_get`
2. **2** Send the welcome email `email_send`
3. **3** Confirm recipient delivery `email_get`

### YouSMS

Text the code 123456 to +14155550100 from +15557654321 and check the delivery status.

#### Bird MCP4 connected actions
1. **1** Read the workspace `workspace_get`
2. **2** Send the SMS code `sms_send`
3. **3** Read the message status `sms_get`
4. **4** Check the delivery event `sms_list_events`

### YouWhatsApp

Send code 123456 to +14155550100 on WhatsApp using our approved bird_otp template, then check it arrived.

#### Bird MCP4 connected actions
1. **1** Read the template catalog `whatsapp_templates_list`
2. **2** Send the approved template `whatsapp_send`
3. **3** Read the message status `whatsapp_get`
4. **4** Check the delivery event `whatsapp_list_events`

### YouEmail + WhatsApp

Send my test customer a welcome email and WhatsApp code 123456 using our approved bird_otp template, then check both arrived.

#### Bird MCP4 connected actions
1. **1** Send the welcome email `email_send`
2. **2** Send the approved template `whatsapp_send`
3. **3** Confirm recipient delivery `email_get`
4. **4** Read the message status `whatsapp_get`

## Connect Base44 to your Bird workspace in three steps.

You need the Base44 Builder plan or higher. Connect Bird with OAuth to inspect your workspace and configure messaging from the editor chat. Base44 saves MCP connections to your account for use across apps and workspaces.

### Custom MCP connection

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

1. **Open custom MCP settings**  
   Click your workspace name, then choose **Account settings** → **Builder** → **MCP Connections** and click **Add custom MCP** to open the form.

2. **Add and authorize Bird**  
   Enter Bird in **Name** and paste the server URL into the **URL** field. Select **OAuth** as the **Authentication** method and leave **Custom headers** empty.

Click **Test** to check the connection, then **Test & Add** to save it. Complete the Bird sign-in and approve the workspace permissions you need.

3. **Confirm the active workspace**  
   Keep Bird enabled in MCP Connections. In the editor chat, ask: “Use Bird to show my signed-in account and current workspace.” Confirm the returned account and workspace before configuring senders or sending test messages.

## Take your Base44 app from workspace prototype to live customer traffic.
Run live email, SMS, WhatsApp, and verification calls through backend secrets, verified senders, and webhook delivery tracking.

### Keep API credentials on the backend

Store your Bird API key in your app's server-side environment secrets and call Bird from backend routes to keep live credentials out of browser code when sending emails, SMS alerts, or verification codes.

### Send from verified domains and numbers

Verify your sending domain and configure approved SMS or WhatsApp senders in Bird before launch so customer notifications, receipts, and sign-in codes pass carrier and inbox checks.

### Track real delivery events in your app

Store the Bird message ID when your app sends a message and subscribe to delivery webhooks so internal dashboards and customer portals show whether a message was delivered, bounced, or failed.

## Start with prompts that inspect senders, configure channels, and debug delivery.

Ask the Base44 agent to check sending domains, set up SMS or WhatsApp for your app, and inspect live delivery or call status against your Bird workspace.

### Understand a delivery issue

```
Check my recent email failures. Group them by reason, inspect the affected sending domain, and tell me what needs fixing before making changes.
```

### Prepare a new channel

```
Help me set up SMS for order updates. Check my workspace and available senders, explain what is missing, then prepare a test for a number I provide.
```

### See what is happening now

```
List the Voice calls that are active right now. Separate connected calls from calls that are still ringing, and show their IDs.
```

## What to know before connecting Base44 to Bird.

How workspace permissions, OAuth sign-in, and backend API credentials work when you build and deploy Base44 apps.

### Common questions

- **Does connecting MCP give my agent unrestricted access?**  
  No, the hosted MCP connection runs with the Bird user role and workspace permissions you approve during OAuth sign-in, and it cannot exceed your account's access. You can revoke the Base44 connection at any time from your Bird account settings.
- **Do I need an API key for hosted MCP?**  
  Bird's hosted MCP server uses OAuth, so you do not need an API key for the editor chat. MCP connections are for building your app. For messaging in a published app, call the Bird API from backend functions with a Bird API key stored in backend secrets.
- **What if the tools appear but calls fail?**  
  Open **Account settings** → **Builder** → **MCP Connections** and confirm Bird is enabled. Click **Test** to check the connection. If authentication fails, repeat the OAuth sign-in. Ask explicitly to use Bird in your prompt.

## Extend your Bird setup across the rest of your AI workflow.
Review MCP permissions, add reusable agent skills for Bird APIs, or connect another coding environment to the same workspace.

### MCP server

Review how Bird's hosted MCP server handles OAuth sign-in, workspace scoping, and tool permissions.

### Agent skills

Install reusable Bird skills so your coding agent follows verified patterns for email, SMS, WhatsApp, and webhooks.

### Other AI tools

Connect editors and agents like Cursor, Claude Code, and Windsurf to the same Bird workspace.

## Start building with Bird in minutes.
