Bird API
urn:air:bird.com:api:openapi
The OpenAPI 3.1 description of every public Bird endpoint: email, SMS, WhatsApp, voice, verify, lookup, contacts, and webhooks.
application/vnd.oai.openapi+json
artifact →
AI Catalog manifest · Bird
Bird
Bird serves an AI Catalog
manifest at /.well-known/ard.json on bird.com, declaring
4 agentic resources
that a discovery service can index without asking anyone’s permission.
Structural grade · AI Catalog 1.0
Near-Conformant
Correctly shaped — every hard check passes — but optional affordances are missing.
ARD conformance-test v0.9.1 (ards-project/ard-spec)
PASS
Run against this exact body with the project’s own
conformance CLI.
Discovery path
ard.json
Served at
/.well-known/ard.json — the path ARD v0.91 says a consumer MUST fetch.
Declared spec version
1.0
The
specVersion in the manifest. 1.0 is current for the AI Catalog data model; anything lower is an earlier draft. ARD reads this field as transport-defined and ignores it.
Optional affordances missing. None of these break a client, but each one costs the publisher search relevance or verifiability.
content-type-not-ai-catalog-jsoncors-not-readable-cross-originentry-no-representativeQuerieshost-identifier-not-did-web
What this manifest advertises
Bird for agents
urn:air:bird.com:agent:llms-txt
The curated index of Bird's agent-facing surfaces: the API, the MCP server, the CLI, and the docs corpus.
text/markdown
artifact →
bird-cli
urn:air:bird.com:skill:bird-cli
Use when operating Bird through the bird CLI to preview or send messages, inspect or manage API resources, or onboard an account; excludes client development.
application/ai-skill+md
artifact →
email-audit
urn:air:bird.com:skill:email-audit
Use when auditing a live domain's email authentication or spam-delivery problems involving DMARC, SPF, DKIM, BIMI, or MX; single-record drafts use bird validators.
application/ai-skill+md
artifact →
How it is served
The publishing guide asks for three things at the transport layer, because a crawler is the
consumer that matters and a crawler is a browser-shaped client.
- HTTPS only — yes (HTTP 200)
Content-Type: application/json— yesAccess-Control-Allow-Origin: *— no — header absent
Evidence. Fetched
https://bird.com/.well-known/ard.json on 2026-09-13, HTTP
200. The verbatim body is stored alongside its manifest in the
Bird repository
as ai-catalog/bird-ai-catalog.json. Nothing on this page is derived
or generated: an AI Catalog manifest is served from the publisher’s own domain or it does not
exist, which makes it — like an
A2A Agent Card — one of the few agent artifacts that cannot be
produced on a provider’s behalf. Grades are recomputed on every build; the specification is a
v0.9 draft and
these verdicts will move when it does.
Work with this as data
Every descriptor here is available over the APIs.io API and to AI agents over MCP. Agent Discovery is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.