Developers · MCP
Ask your station anything.
The StationMonster MCP server lets AI assistants read and work on your stations through the Model Context Protocol. People sign in as themselves, or use an API key, and the assistant can never do more than that person can.
Server address
https://stationmonster.com/mcpWith an API key in a header you can also use https://api.stationmonster.com/functions/v1/mcp.
Try asking
Plain questions, real work.
The assistant picks the right tools, reads the data and answers, or makes the change when its access allows it.
- What did we play between 7 and 8 this morning?
- How many listeners did the morning show peak at yesterday?
- Move tomorrow's 7 a.m. newscast so it comes right after the top-of-hour ID.
- Mark every new listener request from last night as done.
- Add Main Street Motors as an advertiser and start a deal for their spring sale.
- Which songs in the library are missing a year? Fill in the ones you're sure about.
- This song's running long: skip to the next one.
- Tell me when a new listener request comes in.
Safe to connect
Every connection works as one person, with the same checks as the app. When someone signs in they choose read, change or delete, and which stations. Admins and market managers can also make keys for employees and narrow them to certain job permissions, kinds of records, actions or IP addresses. Disconnect or revoke it under Organization › API keys and it's cut off straight away.
Works with
Claude, ChatGPT, Claude Code, Cursor, VS Code and any other client that speaks MCP over Streamable HTTP. Nothing to install or host: it runs on our servers.
Set up
Sign in from your assistant.
The easiest way: add the server address and sign in with your StationMonster account. You'll see what the app is asking for and choose what it can do.
Claude
Settings › Connectors › Add custom connector
Paste https://stationmonster.com/mcp, then click Connect and sign in.
ChatGPT
Connector settings › add a custom connector
Paste https://stationmonster.com/mcp, choose OAuth sign-in, then sign in.
Claude Code
Terminal
Add the server, then type /mcp and pick stationmonster to sign in.
Cursor and VS Code
MCP settings
Add the address with no headers; the editor opens the sign-in page.
Company admins and market managers can always connect apps. Other employees can when a company admin turns on Let employees connect apps under Organization › API keys.
Or use an API key
Claude Code
Cursor
VS Code
Clients that only run local servers
Standards
A complete MCP server.
| Transport | Streamable HTTP. Every request gets one JSON reply, except live change streams, so there's no extra server to run. |
| Live changes | Subscribe to now playing, the players, new listener requests, a day's log or any record, and the assistant is told the moment it changes. Protocol 2026-07-28 uses subscriptions/listen; older clients use resources/subscribe with the session from initialize. A stream lasts up to about 2 minutes (25 seconds through stationmonster.com/mcp), then the client opens a new one. |
| Protocol versions | 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. Newer clients send the version with each request; older ones use the initialize handshake (and batches for 2025-03-26). |
| Tools | Every API operation, with read-only and destructive hints and answer shapes (output schemas) for lists, including the whole Studio (players, carts, faders, on-air control, co-hosts, Mute audio, now-playing text) with the Run the air permission. The assistant only sees the tools its access allows. |
| Test mode | Changes, log edits and actions take dry_run: everything is checked and then undone, so the assistant can show you a change before making it. |
| Safe edits | Single records come with an etag; passing it back as if_match means nothing is overwritten if someone else changed the record meanwhile. |
| Resources | A how-to guide, this connection's limits, each station (details and what's on air), plus templates for now playing, the players, new requests, logs, shows, record types and single records. All of them can be subscribed to. |
| Prompts | Station briefing, check a day's log, find in the library, what aired, sales pipeline, commercials for a day, prepare a newscast, check music rotation, and work with any data. |
| Completions | Station IDs, record types, record IDs, action names, statuses, item types and dates are suggested as you fill things in. |
| History | Every tool call shows under History next to the connection in Organization › API keys, and changes show in the Activity log with the app's name. |
| Sign-in | OAuth 2.1 with PKCE, automatic app registration and client ID metadata documents, refresh tokens that rotate. Discovery documents are at stationmonster.com/.well-known/. |
Tools
What the assistant can use.
get_meWho the key acts as, its company, stations, permissions and limits.
Needs: Stations (or Read everything)
list_stationsEvery station the key can use, with market and time zone.
Needs: Stations (or Read everything)
get_stationOne station's details.
Needs: Stations (or Read everything)
get_now_playingWhat's on air, when it started and the now-playing text.
Needs: Now playing (or Read everything)
list_playsEverything that aired, newest first.
Needs: What aired (or Read everything)
get_logOne station day's log, in order, with each entry's status.
Needs: Logs (or Read everything)
search_librarySearch songs, imaging and commercials.
Needs: Library (or Read everything)
list_showsThe weekly show schedule.
Needs: Show schedule (or Read everything)
list_requestsListener requests and messages.
Needs: Listener requests (or Read everything)
get_listenersListener counts once a minute, plus the peak.
Needs: Listener counts (or Read everything)
get_playoutThe players, fader levels, auto or assist, now-playing text, who holds on-air control, co-hosts and requests to join, Mute audio, and whether the key's person may run the air now.
Needs: Now playing (or Read everything)
list_studiosThe station's studio PCs: open, ready, in control, co-host, asking to join, yours.
Needs: Now playing (or Read everything)
send_playout_commandSkip to the next item, play, stop, pause or recue a player, stop everything, switch auto/assist, jump to a log entry, fire a cart or move a fader.
Needs: Run the air
set_on_air_controlTake on-air control for your studio PC, hand it to another studio, or release it.
Needs: Run the air
set_cohostLet a studio's mic on air as a co-host, or take it off (Let in / Not now).
Needs: Run the air
set_mute_audioMute audio in everyone's talkback headphones (never air), or turn it back on.
Needs: Run the air
set_now_playing_textShow your own now-playing text on streams and radio displays, or clear it.
Needs: Run the air
get_playout_commandWhether the engine has carried out a command yet.
Needs: Now playing (or Read everything)
add_log_entryPut a library item into a day's log, before another entry or at the end.
Needs: Create and change
move_log_entryMove an entry that hasn't started, like dragging it in the Studio log.
Needs: Create and change
swap_log_entriesTwo entries that haven't started trade places, like dropping one player onto another.
Needs: Create and change
remove_log_entryTake an entry that hasn't started out of the log.
Needs: Delete
list_resourcesEvery kind of record the key can work with, and what each allows.
Needs: Read everything
describe_resourceA resource's columns, required fields and checks.
Needs: Read everything
list_recordsFilter, sort and page through records.
Needs: Read everything
get_recordOne record by its key, with its ETag.
Needs: Read everything
create_recordsCreate one record or up to 500 at once; upsert to update existing ones.
Needs: Create and change
update_recordChange some fields of one record (If-Match for safe edits).
Needs: Create and change
update_recordsChange every record matching the filters (up to 1,000).
Needs: Create and change
delete_recordDelete one record.
Needs: Delete
delete_recordsDelete every record matching the filters (up to 1,000).
Needs: Delete
list_actionsThe app's own operations (publishing, moving log entries, merges, invoices, draws, reports…).
Needs: Read everything
call_actionRun an action with named arguments. Ones that change data need write:data; ones that remove data need delete:data.
Needs: Read everything
get_media_audioA download address for a library item's audio file.
Needs: Library (or Read everything)
create_media_uploadAn upload address for a new audio file of an exact size, to add or replace a library item.
Needs: Create and change
Put an assistant on your station.
Start free, add the server to your assistant and sign in.


