Airwave

Airwave — connector documentation

• MCP endpoint: https://airwave.connectorbay.com/mcp
• REST API: POST https://airwave.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://airwave.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://airwave.connectorbay.com/health · Tool schemas: https://airwave.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/airwave · agent@connectorbay.com

What Airwave is for

"Play Radio Mirchi", "some Tamil FM", "BBC Radio 4", "jazz from Paris", "what's on near me" — an assistant can only answer with a stream it can actually open. Airwave turns those requests into direct stream URLs from the largest open directory of internet radio.

What it does

Search the community-maintained Radio Browser directory (50,000+ stations, refreshed by volunteers and automated checks) by station name, country, state, language and tag or genre in any combination, ranked by votes, recent clicks, trend, name or bitrate. Every station returns a resolved stream URL (MP3, AAC or HLS), codec and bitrate, homepage, logo, tags, votes, recent clicks and the directory's online flag. Top-voted, most-clicked and trending lists worldwide or per country. Stations geotagged near a place (34,000-city gazetteer) or coordinates. Browse countries, languages and tags by station count to discover what exists — 12,000 English stations, 5,000 Spanish, 2,000 Chinese, hundreds in Hindi, Tamil, Telugu, Marathi and Bengali. One station's full record by id.

What it is not

Not a player and not the broadcaster: streams belong to the stations, may be geo-restricted or change without notice, and 'online' is the directory's last check, not a live guarantee. Directory data is community-edited, so names, tags and logos vary in quality. No recording, no schedules, no now-playing metadata.

Tools

Find

search_stations — Search stations by any mix of name, country, state, language and tag, ranked by votes (default), recent clicks, trend, name or bitrate; returns stream URLs. Use for "Hindi news radio", "jazz in France", "Tamil FM". Args: name, country, state, language, tag, order, limit.

station — One station's full record by id (stream URL, codec, bitrate, homepage, logo, tags, votes, online). Args: id.

stations_near — Stations geotagged within a radius of a place or coordinates (local FM simulcasts and community stations). Use for "radio stations near Pune". Args: place, latitude, longitude, radius_km, limit.

Discover

top_stations — Most-voted, most-clicked or trending stations worldwide or in a country. Use for "popular radio in India", "what's trending". Args: kind, country, limit.

browse — Countries, languages or tags ranked by station count — to discover what to search for. Use for "which languages have the most stations", "tags starting with 'bolly'". Args: kind, starts_with, limit.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/airwave/support

Airwave — Privacy Policy

Effective 23 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Airwave is. Airwave is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for internet radio: searching stations, top and trending lists, stations near a place and browsing countries, languages and tags. You interact with your assistant; the assistant sends us only the search words, filters, place or station id needed for the lookup.

What we receive. The arguments of each tool call (station name words, a country, language or tag, a place or coordinates, a station id), the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Lookups are forwarded or computed, not stored. Search filters are passed to the Radio Browser directory below; places resolve from a bundled gazetteer (Open-Meteo geocoding only for places not in it). We do not record your queries or build a profile. Nothing you send is stored, logged in request bodies or used to train anything. Successful directory answers are cached in memory for up to an hour, keyed by the query.

What we do not receive or store. We do not receive your conversation with the assistant, your name or contacts or any account credentials. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. Radio Browser (radio-browser.info mirrors) receives the search filters and our server's IP address, never yours. Stream URLs in responses point at the broadcasters' servers; opening a stream is a request from your player to that broadcaster, which we do not see. Hosting: Vercel (United States regions).

Legal bases and your rights. For users in California, the EU/UK and elsewhere, our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Airwave is a general-audience service; we knowingly collect no personal data from anyone.

Changes. We will post changes here with a new effective date.

Airwave — Terms of Service

Effective 23 September 2026. These terms govern use of the Airwave connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Airwave returns internet-radio directory information — station records with stream links, rankings and facets — from the public Radio Browser directory. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Sources and licences. Station data from Radio Browser (radio-browser.info), a community database published for free use; the city gazetteer is derived from GeoNames (CC-BY 4.0). Streams are operated by the respective broadcasters under their own terms; we host no audio.
3. Streams are third-party. We provide links only. Availability, legality in your territory, content and licensing of any stream are the broadcaster's responsibility; do not use the Service to redistribute or record streams without the broadcaster's permission.
4. Acceptable use. Do not use the Service to bulk-scrape the sources or to circumvent rate limits. Automated use within the published limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: your query is forwarded to the radio directory and nothing is stored.
7. Attribution. Radio Browser (radio-browser.info); GeoNames.
8. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
9. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
10. Governing law. California law; venue in San Mateo County, California.
11. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/airwave

Airwave support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://airwave.connectorbay.com/mcp
• REST API: https://airwave.connectorbay.com/openapi.json
• Live status: https://airwave.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Airwave never asks for them.