KAZM Mellow Mountain Radio
KAZM 106.5 FM/780 AM: now playing, weather, fire alerts, road conditions & concerts (Sedona, AZ).
我該用這個嗎
品質與安全性
發現項目(6)
- LOW在 get_horoscope 中
- LOW在 get_solfeggio 中
- LOW在 get_sports_scores 中
- LOW在 get_wildfire_perimeters 中
- LOW在 get_day_in_music_history 中
- LOW在 get_stargazing_conditions 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"kazm": {
"url": "https://mcp.mellowmountainradio.com/mcp"
}
}
}遠端端點
https://mcp.mellowmountainradio.com/mcpstreamable-http它能做什麼
工具清單
工具(46)
🟢get_now_playing
Returns the song currently on air: title, artist, album, artwork URL, start time, and stream URL.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"artist": {
"type": [
"string",
"null"
]
},
"album": {
"type": [
"string",
"null"
]
},
"art": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"started_at": {
"type": [
"string",
"null"
]
},
"elapsed_s": {
"type": [
"number",
"null"
]
},
"duration_s": {
"type": [
"number",
"null"
]
},
"stream_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
}
},
"required": [
"title",
"artist",
"album",
"art",
"started_at",
"elapsed_s",
"duration_s",
"stream_url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_listener_count
Returns the current live listener count across all mounts, plus per-mount breakdown.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"total": {
"type": "number"
},
"unique": {
"type": "number"
},
"mounts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"listeners": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"listeners",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"total",
"unique",
"mounts"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_song_history(query)
Returns the most recently played songs (up to 25). Optionally filter by keyword in title or artist.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keyword to filter by title or artist"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"artist": {
"type": [
"string",
"null"
]
},
"played_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"artist",
"played_at"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_fire_restrictions
Returns current fire restriction level and fire danger rating for the Sedona / Coconino National Forest area. Includes any active Stage 1 or Stage 2 restrictions and Sedona-area alerts.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"agency": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"stage": {
"type": [
"number",
"null"
]
},
"danger": {
"type": [
"string",
"null"
]
},
"sedona_alerts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"text",
"url"
],
"additionalProperties": false
}
},
"notes": {
"type": [
"string",
"null"
]
}
},
"required": [
"updated",
"agency",
"source",
"stage",
"danger",
"sedona_alerts",
"notes"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_weather
Returns current conditions and a 7-day forecast for Sedona AZ from Open-Meteo (free, no key required).
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"generationtime_ms": {
"type": "number"
},
"utc_offset_seconds": {
"type": "number"
},
"timezone": {
"type": "string"
},
"timezone_abbreviation": {
"type": "string"
},
"elevation": {
"type": "number"
},
"current_units": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"current": {
"type": "object",
"additionalProperties": {}
},
"hourly_units": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"hourly": {
"type": "object",
"additionalProperties": {}
},
"daily_units": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"daily": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_road_conditions
Returns active road and trail closures for the Sedona / Oak Creek area from the Coconino National Forest alerts page. Also includes highway incidents for SR-89A, SR-179, and I-17 via Road511 when ROAD511_KEY is set.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
},
"closures": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"incidents": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
}
},
"required": [
"updated",
"sources",
"closures",
"incidents"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_concerts(state)
Returns upcoming concerts and shows sourced from KAZM's data, primarily AZ and regional venues.
輸入結構描述
{
"type": "object",
"properties": {
"state": {
"type": "string",
"description": "Filter by state abbreviation, e.g. 'AZ'"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"count": {
"type": "number"
},
"concerts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"artist": {
"type": "string"
},
"name": {
"type": "string"
},
"venue": {
"type": "string"
},
"date": {
"type": "string"
},
"time": {
"type": "string"
},
"tickets": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"required": [
"updated",
"count",
"concerts"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_events
Returns upcoming local Sedona events including library events and festivals.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"library_events": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"festivals": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
}
},
"required": [
"library_events",
"festivals"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_stream_url
Returns the live audio stream URLs for KAZM (MP3 and AAC mounts) plus the station web player URL.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"web_player": {
"type": "string",
"format": "uri"
},
"streams": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"bitrate": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"format": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"web_player",
"streams"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_show_schedule(day, query)
Returns KAZM's weekly on-air program schedule. Optionally filter by day (weekday, saturday, sunday) or show name keyword.
輸入結構描述
{
"type": "object",
"properties": {
"day": {
"type": "string",
"enum": [
"weekday",
"saturday",
"sunday"
],
"description": "Filter to a specific day group"
},
"query": {
"type": "string",
"description": "Keyword to filter by show name or host"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"station": {
"type": "string"
},
"timezone": {
"type": "string"
},
"schedule": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"station",
"timezone",
"schedule"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_horoscope(sign, period)
Returns daily, weekly, and monthly horoscopes for all signs or a specific sign.
輸入結構描述
{
"type": "object",
"properties": {
"sign": {
"type": "string",
"enum": [
"aries",
"taurus",
"gemini",
"cancer",
"leo",
"virgo",
"libra",
"scorpio",
"sagittarius",
"capricorn",
"aquarius",
"pisces"
],
"description": "Zodiac sign (omit for all)"
},
"period": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly"
],
"description": "Which forecast period (default: daily)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"period": {
"type": [
"string",
"null"
]
},
"horoscopes": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"updated",
"period",
"horoscopes"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_schumann_resonance
Returns the current Schumann resonance reading — Earth's electromagnetic pulse measured at the Tomsk observatory. Includes frequency, energy score, activity level, and spectrogram URL.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"frequency_hz": {
"type": "number"
},
"amplitude": {
"type": "number"
},
"last_updated": {
"type": "string"
},
"source": {
"type": "string"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_sound_session(goal)
Recommends a KAZM sound healing session — binaural or tonal — based on the listener's goal or current time of day. Returns session name, description, frequency, duration, and link.
輸入結構描述
{
"type": "object",
"properties": {
"goal": {
"type": "string",
"enum": [
"sleep",
"focus",
"meditation",
"energy",
"calm",
"anxiety",
"creativity",
"healing"
],
"description": "Listener's intent — omit to get a time-of-day recommendation"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"recommended": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"additionalProperties": {}
}
]
},
"reason": {
"type": "string"
},
"also_available": {
"type": "array",
"items": {}
}
},
"required": [
"recommended"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_chakra_guide(chakra)
Full guide to the seven chakras — Sanskrit name, Solfeggio frequency, musical note, color, element, bija mantra, petal count, governing theme, balanced and blocked states, affirmation, crystals, essential oils, yoga pose, and the Sedona vortex tied to each center.
輸入結構描述
{
"type": "object",
"properties": {
"chakra": {
"type": "string",
"enum": [
"root",
"sacral",
"solar_plexus",
"heart",
"throat",
"third_eye",
"crown"
],
"description": "Specific chakra — omit for all seven"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chakras": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"note": {
"type": "string"
},
"chakra_sound_bath": {
"type": "string"
},
"sound_healing_page": {
"type": "string"
}
},
"required": [
"chakras"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_chakra_frequencies(chakra)
Returns the seven Solfeggio chakra frequencies with musical notes, colors, and affirmations. For the full guide (crystals, oils, poses, Sedona vortex) use get_chakra_guide.
輸入結構描述
{
"type": "object",
"properties": {
"chakra": {
"type": "string",
"enum": [
"root",
"sacral",
"solar_plexus",
"heart",
"throat",
"third_eye",
"crown"
],
"description": "Specific chakra — omit for all seven"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"chakras": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"tip": {
"type": "string"
},
"chakra_sound_bath": {
"type": "string"
}
},
"required": [
"chakras"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_solfeggio(hz)
Returns the nine-tone Solfeggio frequency scale with each tone's traditional healing properties, note name, and use cases. These frequencies underpin modern sound healing practice.
輸入結構描述
{
"type": "object",
"properties": {
"hz": {
"type": "integer",
"description": "Look up a specific frequency in Hz — e.g. 528"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"frequencies": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"note": {
"type": "string"
},
"sound_healing_page": {
"type": "string"
}
},
"required": [
"frequencies"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_song_request_library(query)
Search KAZM's requestable song library by artist or title keyword. Returns matching tracks the DJ can play on request.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Artist name or song title to search for"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"count": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"artist": {
"type": "string"
}
},
"required": [
"title",
"artist"
],
"additionalProperties": false
}
}
},
"required": [
"query",
"count",
"results"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_rewind
Returns available on-demand rewind blocks — past KAZM broadcasts you can listen to, with dates and stream URLs.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"count": {
"type": "number"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"start_hour": {
"type": "number"
},
"url": {
"type": "string"
}
},
"required": [
"date",
"start_hour",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"count",
"blocks"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_jeep_trails(trail)
Returns Sedona jeep trail names available on the KAZM trail map. Pass a trail name to get its GPS coordinate path.
輸入結構描述
{
"type": "object",
"properties": {
"trail": {
"type": "string",
"description": "Trail slug, e.g. 'broken-arrow', 'schnebly'. Omit for the full list."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"trails": {
"type": "array",
"items": {}
},
"map_url": {
"type": "string"
},
"trail": {
"type": "string"
},
"coordinates": {
"type": "array",
"items": {}
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_movies
Returns current movie showings at Sedona-area theaters (Mary D. Fisher Theatre, Harkins Sedona 6, and others).
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"venues": {
"type": "array",
"items": {}
},
"showings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
}
},
"required": [
"updated",
"venues",
"showings"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_emergency_alerts(severity)
Returns active Emergency Alert System (EAS) alerts for the Sedona area — Yavapai and Coconino counties. Covers weather emergencies, evacuation orders, Amber Alerts, and all FEMA IPAWS-distributed alerts. Data is live from the National Weather Service public API.
輸入結構描述
{
"type": "object",
"properties": {
"severity": {
"type": "string",
"enum": [
"Extreme",
"Severe",
"Moderate",
"Minor"
],
"description": "Filter to alerts at or above this severity level (Extreme > Severe > Moderate > Minor)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"counties": {
"type": "array",
"items": {
"type": "string"
}
},
"count": {
"type": "number"
},
"alerts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"event": {
"type": "string"
},
"headline": {
"type": "string"
},
"description": {
"type": "string"
},
"instruction": {
"type": "string"
},
"severity": {
"type": "string"
},
"urgency": {
"type": "string"
},
"certainty": {
"type": "string"
},
"areas": {
"type": "string"
},
"sender": {
"type": "string"
},
"effective": {
"type": "string"
},
"expires": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"event"
],
"additionalProperties": false
}
}
},
"required": [
"updated",
"counties",
"count",
"alerts"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡submit_song_request(query, name, note)
Submit a song request to KAZM 106.5 FM & 780 AM via the station website. Searches the real studio library, then logs the request for the DJ — every request gets read. Provide both song title and artist for best results.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Song title and/or artist name, e.g. 'Sailing Christopher Cross' or 'Truckin Grateful Dead'"
},
"name": {
"type": "string",
"maxLength": 60,
"description": "Your name and town for the request card, e.g. 'Sarah from Sedona' (optional)"
},
"note": {
"type": "string",
"maxLength": 140,
"description": "A dedication or message, e.g. 'Happy birthday Maria!' (optional)"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"submitted": {
"type": "boolean"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"message": {
"type": "string"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
}
},
"required": [
"success"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_local_news_headlines(limit)
Returns the latest Sedona and Verde Valley local news headlines. Pulls live from the Sedona Red Rock News and Verde Independent RSS feeds. Covers local government, arts, community events, real estate, and Verde Valley news.
輸入結構描述
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Max headlines to return per source (default 8)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"feeds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"count": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"link": {
"type": [
"string",
"null"
]
},
"published": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
}
},
"required": [
"title"
],
"additionalProperties": true
}
}
},
"required": [
"source",
"count",
"items"
],
"additionalProperties": false
}
},
"errors": {
"type": "array",
"items": {}
}
},
"required": [
"updated",
"feeds"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_air_quality
Returns current air quality index (AQI) and pollutant readings for Sedona, AZ from Open-Meteo. Includes US AQI category, PM2.5, PM10, ozone, and UV index. Especially useful during wildfire season for tracking smoke and outdoor safety.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"location": {
"type": "string"
},
"coordinates": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lon": {
"type": "number"
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": false
},
"updated": {
"type": [
"string",
"null"
]
},
"us_aqi": {
"type": [
"number",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"pm2_5_ug_m3": {
"type": [
"number",
"null"
]
},
"pm10_ug_m3": {
"type": [
"number",
"null"
]
},
"ozone_ug_m3": {
"type": [
"number",
"null"
]
},
"uv_index": {
"type": [
"number",
"null"
]
},
"dust_ug_m3": {
"type": [
"number",
"null"
]
},
"carbon_monoxide": {
"type": [
"number",
"null"
]
},
"nitrogen_dioxide": {
"type": [
"number",
"null"
]
},
"source": {
"type": "string"
}
},
"required": [
"location",
"coordinates",
"updated",
"us_aqi",
"category",
"pm2_5_ug_m3",
"pm10_ug_m3",
"ozone_ug_m3",
"uv_index",
"dust_ug_m3",
"carbon_monoxide",
"nitrogen_dioxide",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_sports_scores(team)
Returns current and recent scores for Arizona sports teams — Cardinals (NFL), Suns (NBA), D-backs (MLB), Mercury (WNBA), ASU Sun Devils, Arizona Wildcats, NAU Lumberjacks, and UFC events. Powered by ESPN.
輸入結構描述
{
"type": "object",
"properties": {
"team": {
"type": "string",
"enum": [
"cardinals",
"suns",
"dbacks",
"mercury",
"asu",
"wildcats",
"arizona",
"nau",
"ufc"
],
"description": "Filter by team — omit for all Arizona teams"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"scores": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"updated",
"scores"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_sun_times(date)
Returns sunrise, sunset, solar noon, day length, golden hours, and astronomical twilight for Sedona from the KAZM transmitter site. Optional date param for any day. Also flags next solstice and equinox.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date in YYYY-MM-DD format — omit for today"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string"
},
"location": {
"type": "string"
},
"sunrise": {
"type": "string"
},
"sunset": {
"type": "string"
},
"solar_noon": {
"type": "string"
},
"day_length_seconds": {
"type": "number"
},
"civil_twilight_begin": {
"type": "string"
},
"civil_twilight_end": {
"type": "string"
},
"nautical_twilight_begin": {
"type": "string"
},
"nautical_twilight_end": {
"type": "string"
},
"astronomical_twilight_begin": {
"type": "string"
},
"astronomical_twilight_end": {
"type": "string"
},
"next_solstice_or_equinox": {
"type": "object",
"additionalProperties": {}
},
"source": {
"type": "string"
}
},
"required": [
"date",
"location",
"sunrise",
"sunset",
"solar_noon",
"day_length_seconds",
"civil_twilight_begin",
"civil_twilight_end",
"nautical_twilight_begin",
"nautical_twilight_end",
"astronomical_twilight_begin",
"astronomical_twilight_end",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_moon_phase(date)
Returns tonight's moon phase for Sedona, AZ — illumination percent, phase name, and a 7-day lunar calendar. Perfect for stargazing and outdoor planning.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date YYYY-MM-DD (default today)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"location": {
"type": "string"
},
"today": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"phase": {
"type": "string"
},
"emoji": {
"type": "string"
},
"illumination_pct": {
"type": "number"
},
"moon_age_days": {
"type": "number"
}
},
"required": [
"date",
"phase",
"emoji",
"illumination_pct",
"moon_age_days"
],
"additionalProperties": false
},
"next_7_days": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"source": {
"type": "string"
}
},
"required": [
"location",
"today",
"next_7_days",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_vortex_guide(site)
Returns a guide to Sedona's four famous energy vortex sites — Bell Rock, Cathedral Rock, Airport Mesa, and Boynton Canyon. Includes directions, hiking info, best visit times, and energy type.
輸入結構描述
{
"type": "object",
"properties": {
"site": {
"type": "string",
"enum": [
"bell_rock",
"cathedral_rock",
"airport_mesa",
"boynton_canyon"
],
"description": "Filter to one vortex site"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"location": {
"type": "string"
},
"note": {
"type": "string"
},
"vortex_sites": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
{
"type": "object",
"additionalProperties": {}
}
]
}
},
"required": [
"location",
"vortex_sites"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_nws_alerts
Returns active National Weather Service alerts for the Sedona / Yavapai County area — watches, warnings, and advisories. Returns empty when conditions are clear.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"location": {
"type": "string"
},
"updated": {
"type": [
"string",
"null"
]
},
"alert_count": {
"type": "number"
},
"alerts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event": {
"type": "string"
},
"severity": {
"type": "string"
},
"urgency": {
"type": "string"
},
"headline": {
"type": "string"
},
"description": {
"type": "string"
},
"instruction": {
"type": "string"
},
"effective": {
"type": "string"
},
"expires": {
"type": "string"
},
"areas": {
"type": "string"
}
},
"required": [
"event"
],
"additionalProperties": false
}
},
"source": {
"type": "string"
}
},
"required": [
"location",
"updated",
"alert_count",
"alerts",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_oak_creek_levels
Returns current Oak Creek stream level and discharge at the Sedona USGS gauge. Useful for creek crossing safety, swimming holes, and recreation planning.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"station": {
"type": "string"
},
"station_id": {
"type": "string"
},
"updated": {
"type": [
"string",
"null"
]
},
"level_label": {
"type": "string"
},
"discharge_cfs": {
"anyOf": [
{
"anyOf": [
{
"type": "number"
},
{
"type": "object",
"additionalProperties": {}
}
]
},
{
"type": "null"
}
]
},
"gage_height_ft": {
"anyOf": [
{
"anyOf": [
{
"type": "number"
},
{
"type": "object",
"additionalProperties": {}
}
]
},
{
"type": "null"
}
]
},
"source": {
"type": "string"
}
},
"required": [
"station",
"station_id",
"updated",
"level_label",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_artist_info(artist)
Returns biography, genre tags, and album discography for the artist currently on KAZM, or any named artist, from MusicBrainz (open music encyclopedia).
輸入結構描述
{
"type": "object",
"properties": {
"artist": {
"type": "string",
"description": "Artist name — omit to use the current now-playing artist"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"searched_for": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"disambiguation": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"life_span": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"albums": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"year": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"year"
],
"additionalProperties": false
}
},
"musicbrainz_id": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
}
},
"required": [
"searched_for",
"name",
"disambiguation",
"type",
"country",
"life_span",
"tags",
"albums",
"musicbrainz_id",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_wildfire_perimeters
Returns active wildfire incidents within ~150 miles of Sedona from the National Interagency Fire Center (NIFC). Especially critical during Arizona fire season (April–July). Returns name, acreage, containment, and distance from Sedona.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"updated": {
"type": [
"string",
"null"
]
},
"search_area": {
"type": "string"
},
"active_fire_count": {
"type": "number"
},
"fires": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"state": {
"type": "string"
},
"acres": {
"type": "number"
},
"contained_pct": {
"type": "number"
},
"discovered": {
"type": "string"
},
"behavior": {
"type": "string"
},
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"dist_mi_from_sedona": {
"type": "number"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"source": {
"type": "string"
}
},
"required": [
"updated",
"search_area",
"active_fire_count",
"fires",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_day_in_music_history(date)
Returns notable music events that happened on this day in history — album releases, iconic concerts, chart milestones, artist birthdays — from Wikipedia's On This Day feed. Great for on-air trivia.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date as MM-DD or YYYY-MM-DD — omit for today"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string"
},
"music_events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "number"
},
"event": {
"type": "string"
}
},
"required": [
"year",
"event"
],
"additionalProperties": false
}
},
"music_birthdays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "number"
},
"person": {
"type": "string"
}
},
"required": [
"year",
"person"
],
"additionalProperties": false
}
},
"music_passings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "number"
},
"person": {
"type": "string"
}
},
"required": [
"year",
"person"
],
"additionalProperties": false
}
},
"source": {
"type": "string"
}
},
"required": [
"date",
"music_events",
"music_birthdays",
"music_passings",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_visitor_info(topic)
Returns practical visitor information for Sedona, AZ — Red Rock Pass requirements, state park hours and fees, popular attractions, best seasons to visit, and local tips. Perfect for tourist queries.
輸入結構描述
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"enum": [
"parks",
"passes",
"attractions",
"seasons",
"tips",
"all"
],
"description": "Category of info — omit for all"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"location": {
"type": "string"
},
"last_verified": {
"type": [
"string",
"null"
]
},
"info": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"location",
"last_verified",
"info"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_red_rock_pass(topic)
Complete Red Rock Pass guide for Sedona / Coconino National Forest — all 19 required sites, current fees, accepted passes (America the Beautiful, Senior, Access), where to buy, shuttle info, and Soldier Pass permit details. Answers the most common Sedona visitor question.
輸入結構描述
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"enum": [
"fees",
"sites",
"shuttles",
"passes",
"buy",
"all"
],
"description": "fees | sites | shuttles | passes | buy | all (default)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"fees": {
"type": "object",
"additionalProperties": {}
},
"passes": {
"type": "object",
"additionalProperties": {}
},
"sites": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
{
"type": "object",
"additionalProperties": {}
}
]
},
"shuttles": {
"type": "object",
"additionalProperties": {}
},
"where_to_buy": {
"type": "array",
"items": {}
},
"tips": {
"type": "array",
"items": {
"type": "string"
}
},
"kazm_note": {
"type": "string"
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_hiking_trails(trail, difficulty)
Sedona hiking trail guide — distance, elevation gain, difficulty, trailhead location, Red Rock Pass requirement, access restrictions (shuttle/permit), and pro tips for 15 of the best trails in Red Rock Country.
輸入結構描述
{
"type": "object",
"properties": {
"trail": {
"type": "string",
"description": "Trail name keyword, e.g. 'devil' or 'cathedral' — omit for all trails"
},
"difficulty": {
"type": "string",
"enum": [
"easy",
"moderate",
"strenuous"
],
"description": "Filter by difficulty"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"trails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"distance_mi": {
"type": "number"
}
},
"required": [
"name"
],
"additionalProperties": true
}
},
"total": {
"type": "number"
},
"red_rock_pass_required": {
"type": [
"boolean",
"string"
]
},
"shuttle_info": {
"type": "string"
},
"oak_creek_tip": {
"type": "string"
},
"source": {
"type": "string"
},
"kazm_note": {
"type": "string"
}
},
"required": [
"trails"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_stargazing_conditions(date)
Returns tonight's stargazing forecast for Sedona, AZ — astronomical darkness window, moon interference, Milky Way galactic core visibility, and best times to shoot the night sky. Sedona sits near the Verde Valley Dark Sky corridor.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Date YYYY-MM-DD (default tonight)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"date": {
"type": "string"
},
"location": {
"type": "string"
},
"darkness": {
"type": "object",
"properties": {
"astronomical_twilight_end": {
"type": "string"
},
"astronomical_twilight_begin": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"astronomical_twilight_end",
"astronomical_twilight_begin",
"note"
],
"additionalProperties": false
},
"moon": {
"type": "object",
"properties": {
"phase": {
"type": "string"
},
"emoji": {
"type": "string"
},
"illumination_pct": {
"type": "number"
},
"moon_age_days": {
"type": "number"
},
"interference_rating": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"phase",
"emoji",
"illumination_pct",
"moon_age_days",
"interference_rating",
"note"
],
"additionalProperties": false
},
"milky_way": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"status",
"note"
],
"additionalProperties": false
},
"top_sites": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"why": {
"type": "string"
}
},
"required": [
"name",
"why"
],
"additionalProperties": false
}
},
"source": {
"type": "string"
}
},
"required": [
"date",
"location",
"darkness",
"moon",
"milky_way",
"top_sites",
"source"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_photography_guide(location)
Returns Sedona photography locations with today's real golden hour / blue hour times, current light quality score, and camera settings for each scenario. Great for landscape and astrophotography planning.
輸入結構描述
{
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"cathedral_rock",
"airport_mesa",
"bell_rock",
"chapel_holy_cross",
"devils_bridge",
"oak_creek_canyon"
],
"description": "Filter to a single location — omit for all 6"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"location_context": {
"type": "string"
},
"date": {
"type": "string"
},
"current_light_phase": {
"type": "string"
},
"current_light_score": {
"type": [
"number",
"string"
]
},
"today_times": {
"type": "object",
"additionalProperties": {}
},
"locations": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
{
"type": "object",
"additionalProperties": {}
}
]
}
},
"required": [
"location_context",
"date",
"current_light_phase",
"today_times",
"locations"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_tarot_card(spread, card_name)
Draws from the full 78-card Rider-Waite tarot deck. Returns the card of the day over Sedona (same for all listeners, turns at midnight MST), a single random draw, or a three-card past/present/future spread. Each card includes upright and reversed meanings, astrological correspondence, and suit element.
輸入結構描述
{
"type": "object",
"properties": {
"spread": {
"type": "string",
"enum": [
"daily",
"single",
"three"
],
"description": "daily = today's card of the day (deterministic, Sedona date); single = one random card; three = past/present/future. Defaults to daily."
},
"card_name": {
"type": "string",
"description": "Look up a specific card by name, e.g. 'The Tower' or 'Ten of Cups'. Returns full upright and reversed meanings."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"spread": {
"type": "string"
},
"date": {
"type": "string"
},
"note": {
"type": "string"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"position": {
"type": "string"
},
"card": {
"type": "string"
},
"glyph": {
"type": "string"
},
"tag": {
"type": "string"
},
"astro": {
"type": "string"
},
"orientation": {
"type": "string"
},
"meaning": {
"type": "string"
},
"upright": {
"type": "string"
},
"reversed": {
"type": "string"
}
},
"required": [
"card",
"glyph",
"tag",
"upright",
"reversed"
],
"additionalProperties": false
}
},
"card": {
"type": "string"
},
"glyph": {
"type": "string"
},
"tag": {
"type": "string"
},
"astro": {
"type": "string"
},
"upright": {
"type": "string"
},
"reversed": {
"type": "string"
},
"tarot_page": {
"type": "string"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡register_listener(name, email, location, language, genres)
Create or update a KAZM listener profile. Returns a listener_id that persists across AI sessions — saves name, location, language, and favorite genres so any future AI session can deliver a fully personalized Mellow Mountain Radio experience without starting from scratch.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Listener's name or nickname"
},
"email": {
"type": "string",
"description": "Email address (optional — used to find existing profile)"
},
"location": {
"type": "string",
"description": "City and country, e.g. 'Berlin, Germany' or 'Los Angeles, CA'"
},
"language": {
"type": "string",
"enum": [
"en",
"de",
"es",
"fr",
"pt",
"ja"
],
"description": "Preferred language for KAZM content: en/de/es/fr/pt/ja (default en)"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Favorite music genres, e.g. ['classic rock','jazz','blues']"
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string"
},
"status": {
"type": "string"
},
"name": {
"type": "string"
},
"language": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"message": {
"type": "string"
}
},
"required": [
"listener_id",
"status",
"name",
"language",
"location",
"genres",
"message"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡get_or_create_listener(listener_id, email, name, language, location, ...)
The zero-friction entry point for KAZM personalization. Pass whatever you know — listener_id, email, or just a name — and this tool either returns the existing profile or silently creates one in a single call. No separate registration step needed. Call this at the start of every listener session.
輸入結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string",
"description": "The listener's unique KAZM ID if already known (from custom instructions or previous session)"
},
"email": {
"type": "string",
"description": "Listener's email address — used to find or link their profile"
},
"name": {
"type": "string",
"description": "Listener's name — used when creating a new profile"
},
"language": {
"type": "string",
"enum": [
"en",
"de",
"es",
"fr",
"pt",
"ja"
],
"description": "Preferred language — set on creation, or updates existing profile"
},
"location": {
"type": "string",
"description": "City and country — set on creation or update"
},
"genres": {
"type": "array",
"items": {
"type": "string"
},
"description": "Favorite music genres — set on creation or update"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string"
},
"status": {
"type": "string"
},
"name": {
"type": "string"
},
"language": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"preferences": {
"type": "object",
"additionalProperties": {}
},
"recent_history": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"save_hint": {
"type": "string"
},
"personalization_tip": {
"type": "string"
}
},
"required": [
"listener_id",
"status",
"name",
"language",
"location",
"genres",
"preferences",
"recent_history"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_listener_profile(listener_id, email)
Retrieve a KAZM listener's full profile — by listener_id OR by email address. Either identifier works. Use at the start of any session to instantly personalize the experience. If the listener has their KAZM ID saved in Claude custom instructions, use that; otherwise look them up by email.
輸入結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string",
"description": "The listener's unique ID (from register_listener or saved in custom instructions)"
},
"email": {
"type": "string",
"description": "Email address — alternative to listener_id. Use if the listener's email is known."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"language": {
"type": "string"
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"preferences": {
"type": "object",
"additionalProperties": {}
},
"member_since": {
"type": [
"string",
"null"
]
},
"last_seen": {
"type": [
"string",
"null"
]
},
"total_sessions": {
"type": "number"
},
"recent_history": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"personalization_tip": {
"type": "string"
}
},
"required": [
"id",
"name",
"location",
"language",
"genres",
"preferences",
"member_since",
"last_seen",
"total_sessions",
"recent_history"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_listener_preference(listener_id, key, value)
Update a specific preference for a KAZM listener — language, location, favorite genre, or any custom key. Persists across all future AI sessions.
輸入結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string",
"description": "The listener's unique ID"
},
"key": {
"type": "string",
"description": "Preference key: 'language', 'location', 'genres' (comma-separated), 'favorite_show', or any custom key"
},
"value": {
"type": "string",
"description": "New value for the preference"
}
},
"required": [
"listener_id",
"key",
"value"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"listener_id": {
"type": "string"
},
"updated": {
"type": "object",
"additionalProperties": {}
},
"updated_at": {
"type": "string"
}
},
"required": [
"ok",
"listener_id",
"updated",
"updated_at"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢log_listener_history(listener_id, event_type, title, artist, notes)
Log a listening event for a KAZM listener — a song that played, a show they tuned into, a request they made. Builds the history that powers smarter recommendations in every future session. Call this whenever something notable happens in a listener's session.
輸入結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string",
"description": "The listener's unique ID"
},
"event_type": {
"type": "string",
"enum": [
"song_played",
"show_tuned_in",
"song_requested",
"session_start",
"session_end",
"reacted"
],
"description": "Type of event"
},
"title": {
"type": "string",
"description": "Song title or show name"
},
"artist": {
"type": "string",
"description": "Artist name (for songs)"
},
"notes": {
"type": "string",
"description": "Extra context: 'loved it', 'skipped after 10s', 'requested via AI', etc."
}
},
"required": [
"listener_id",
"event_type"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"logged": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
},
"artist": {
"type": [
"string",
"null"
]
},
"notes": {
"type": [
"string",
"null"
]
},
"timestamp": {
"type": "string"
}
},
"required": [
"type",
"title",
"artist",
"notes",
"timestamp"
],
"additionalProperties": false
},
"total_events": {
"type": "number"
}
},
"required": [
"ok",
"logged",
"total_events"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_personalized_content(listener_id, email, content_type)
Returns a fully personalized KAZM experience — greeting in the listener's language, recommendations from their history, station brief. Accepts listener_id OR email, so no separate registration step is ever needed. Pairs perfectly with get_or_create_listener.
輸入結構描述
{
"type": "object",
"properties": {
"listener_id": {
"type": "string",
"description": "The listener's unique ID"
},
"email": {
"type": "string",
"description": "Email address — alternative to listener_id"
},
"content_type": {
"type": "string",
"enum": [
"greeting",
"recommendations",
"full"
],
"description": "greeting = localized welcome only; recommendations = based on history; full = everything (default)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"listener": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"language": {
"type": "string"
}
},
"required": [
"id",
"name",
"location",
"language"
],
"additionalProperties": false
},
"greeting": {
"type": "string"
},
"recommendations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"session_tip": {
"type": "string"
}
},
"required": [
"listener"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_broadcast_transcripts(query, types, date, limit)
Search every word spoken on KAZM's airwaves — weather reports, local news, live talk breaks, and syndicated shows, machine-transcribed from the station's own broadcast tapes. The archive begins July 2026 and grows four blocks a day, forever. Commercials and PSAs are never archived. Times are Arizona (Phoenix, UTC-7). Pairs with search_song_history: that tool answers what was PLAYED, this one answers what was SAID.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Words to search for in the spoken-word archive, e.g. 'fire restrictions' or 'doctor'"
},
"types": {
"type": "string",
"description": "Comma-separated segment types to search: talk (KAZM's own voice — weather, news, breaks), show (syndicated programming), live (live broadcasts), music (words captured over songs). Default 'talk,show,live'."
},
"date": {
"type": "string",
"description": "Limit to one broadcast day, YYYY-MM-DD"
},
"limit": {
"type": "number",
"description": "Max matches to return (default 25, max 100)"
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據