24 actions ready for your AI

Connect Bird to your AI

Add your Bird key once and every AI you use can list email messages, create email messages and list domains through it.

Needs your API keyWorks today: paste the key from this app and your AI can use it. One-click sign-in is not built yet.

Not verified by us yet. Its actions come from Bird's own documented API, and we have not run them here yet.

Use your own Bird account. Credentials stay encrypted in ahel.

Tell me when ahel has verified Bird

What your AI can do with Bird

Choose a task and ask your AI.

Email

  • List email messagesGET

    List messages

    limit
    Maximum number of items to return per page.
    starting_after
    Cursor from the nextcursor field of a previous list response.
    ending_before
    Cursor from the prevcursor or refreshcursor field of a previous list response.
    created_after
    Limits the response to resources created at or after this timestamp.
  • Create email messagePOST

    Create an email message

    fromrequired
    A sender or recipient address.
    torequired
    Primary recipients.
    Idempotency-Key
    Client-supplied deduplication key.
    cc
    CC recipients.
  • Create email message batchPOST

    Create a batch of email messages

    bodyrequired
    Batch of email message send requests.
    Idempotency-Key
    Client-supplied deduplication key.
  • List email threadsGET

    List threads

    mailbox_id
    Filter to conversations in a specific mailbox.
    contact_id
    Filter to conversations linked to a specific contact.
    label
    Filter to conversations that have this label.
    has_unread
    When true, only conversations with unread messages are returned.
  • Get email stats dailyGET

    Get daily sending statistics

    from
    Start date (inclusive), YYYY-MM-DD. Interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive), YYYY-MM-DD. Interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Restrict the statistics to a single category: transactional or marketing.
  • Get email stats hourlyGET

    Get hourly sending statistics

    from
    Start of the window (ISO 8601 instant).
    to
    End of the window (ISO 8601 instant).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Restrict the statistics to a single category: transactional or marketing.
  • Get email stats by tagGET

    Get statistics by tag

    from
    Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Not supported on breakdown endpoints.
  • Get email stats summaryGET

    Get aggregate email statistics

    from
    Inclusive start of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour).
    to
    Inclusive end of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Restrict the statistics to a single category: transactional or marketing.
  • Get email stats by sending ipGET

    Get statistics by sending IP

    from
    Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Not supported on breakdown endpoints.
  • Get email stats by sending domainGET

    Get statistics by sending domain

    from
    Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Not supported on breakdown endpoints.
  • Get email stats by categoryGET

    Get statistics by category

    from
    Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    sort
    Metric to rank rows by, applied descending.
  • Get email stats by mailbox providerGET

    Get statistics by mailbox provider

    from
    Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Not supported on breakdown endpoints; supplying it returns 422.
  • Get email stats by mailbox provider regionGET

    Get statistics by mailbox provider region

    from
    Start date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    to
    End date (inclusive) in YYYY-MM-DD, interpreted as a calendar day in timezone (a UTC day when timezone is omitted).
    timezone
    IANA timezone identifier used to group statistics, for example Asia/Kathmandu.
    category
    Not supported on breakdown endpoints.

Inbound

  • List inbound addressesGET

    List inbound addresses

    limit
    Maximum number of items to return per page.
    starting_after
    Cursor from the nextcursor field of a previous list response.
    ending_before
    Cursor from the prevcursor or refreshcursor field of a previous list response.
  • Create inbound addressPOST

    Create an inbound address

    Idempotency-Key
    Client-supplied deduplication key.
    label
    Your own label for this address, typically the source mailbox it maps to.
  • List inbound messagesGET

    List received emails

    from
    Filter to messages whose sender address matches this value exactly.
    inbound_address_id
    Filter to messages received on a specific inbound address.
    received_after
    Filter to messages received at or after this time.
    received_before
    Filter to messages received at or before this time.
  • List inbound routesGET

    List inbound routes

    domain
    Filter to routes on this domain.
    enabled
    Set to true for active routes or false for routes skipped during evaluation.
    limit
    Maximum number of items to return per page.
    starting_after
    Cursor from the nextcursor field of a previous list response.
  • Create inbound routePOST

    Create an inbound route

    domainrequired
    The domain the route applies to.
    match_typerequired
    How the route matches recipients.
    actionrequired
    What happens to matching mail.
    Idempotency-Key
    Client-supplied deduplication key.

Domain

  • List domainsGET

    List sending domains

    name
    Substring match against the domain name (case-insensitive).
    sort
    Field to sort by.
    order
    Sort direction.
    limit
    Maximum number of items to return per page.
  • Create domainPOST

    Create a sending domain

    domainrequired
    The domain you send from: the domain of your from addresses.
    Idempotency-Key
    Client-supplied deduplication key.
    return_path
    Return-path (bounce) domain configuration.
    tracking
    Tracking domain configuration for branded open and click tracking URLs.

Mailbox

  • List mailboxesGET

    List mailboxes

    address
    Filter to the mailbox with exactly this address.
    q
    Case-insensitive search matching the mailbox's address or display name (substring).
    state
    Return only active or suspended mailboxes.
    domain
    Filter to mailboxes whose address is on this domain.
  • Create mailboxPOST

    Create a mailbox

    Idempotency-Key
    Client-supplied deduplication key.
    local_part
    The local part of the mailbox address (the part before @).
    domain
    The domain the address lives under.
    display_name
    Display name used as the sender name on mail from this mailbox.
Show 1 more group

Suppression

  • List suppressionsGET

    List suppressions

    email
    Case-insensitive prefix filter on the address.
    reason
    Return only suppressions with this reason: - hardbounce: Delivery permanently failed.
    scope_type
    Return only suppressions with this scope.
    limit
    Maximum number of items to return per page.
  • Create suppressionPOST

    Create a suppression

    emailrequired
    The address to stop sending to.
    Idempotency-Key
    Client-supplied deduplication key.

Ask your AI

Try one of these requests with a connected AI.

  • List my email messages in Bird
  • Create an email message in Bird
  • List my domains in Bird
  • Create a domain in Bird
  • List my suppressions in Bird
  • Create a suppression in Bird

Bird MCP server, hosted by ahel

One hosted endpoint serves Bird. There is nothing to install and no local server to run.

Connect Bird to Claude, Claude Code, Cursor or Codex

  1. Add your Bird key. ahel stores it encrypted.
  2. Paste one link into your AI: https://mcp.ahel.ai (once, for every app).
  3. Ask for the work. Your AI picks the action and ahel runs it with your key.

Documentation

About Bird

Bird is a messaging service. Connect your own key and your AI can list email messages, create email messages and list domains.

Bird over MCP: ahel serves Bird to Claude, Claude Code, Cursor and Codex as one hosted MCP endpoint. There is no local server to run. Add your Bird key once, paste one link into your AI, and the actions above are there.

Messaging

Questions

Is my Bird key safe?

Your Bird key is sealed in ahel and added to the request server-side when your AI calls Bird. It never crosses the MCP link, no tool can read it back, and you can turn the app off or remove the key at any time.

Which AIs can use Bird through ahel?

Any MCP-capable AI: Claude, Claude Code, Codex, Cursor, VS Code and others. Paste one link, https://mcp.ahel.ai, into the AI once and everything in your gateway arrives through it.

What can my AI do with Bird?

24 actions today, covering emails, inbounds and domains. Ask in plain language; your AI picks the action and ahel runs it with your key.

Does connecting Bird cost anything?

Connecting apps is free during ahel's early access. Free, Pro and Team all cost nothing today, and the pricing page lists what each one includes. Bird may bill you for API use under its own terms.