Ausha MCP by usefulapi
Read shows, episodes and campaigns; manage playlists of episodes in Ausha.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin ausha_remove_podcast_from_playlist
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"ausha": {
"url": "https://ausha.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://ausha.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (17)
🟢ausha_list_shows(minimal, page, per_page)
List the podcast shows this token can access: the shows the account owns and the shows shared with it. Start here to find a show id. Ausha API: GET /v1/shows/granted (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"minimal": {
"description": "true returns a lighter response body (transformer=minimal).",
"type": "boolean"
},
"page": {
"description": "Page number for pagination (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page (default 15).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_show(show_id)
Get one show by its numeric id. Ausha API: GET /v1/shows/{show} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"show_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric show id (from ausha_list_shows)."
}
},
"required": [
"show_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_show_by_public_id(public_id)
Get one show by its public id (the id in its public URL). Ausha API: GET /v1/shows/public_id/{showByPublicId} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"public_id": {
"type": "string",
"minLength": 1,
"description": "Public id of the show."
}
},
"required": [
"public_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_list_seasons(show_id)
List the seasons of a show, with the podcast count per season. Ausha API: GET /v1/shows/{show}/seasons (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"show_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric show id (from ausha_list_shows)."
}
},
"required": [
"show_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_season(season_id)
Get one season by its numeric id. Ausha API: GET /v1/seasons/{season} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"season_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the season."
}
},
"required": [
"season_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_list_campaigns(show_id, q, page, per_page)
List the ad campaigns of a show (name, type, state, dates, listen limits). Ausha API: GET /v1/shows/{show}/campaigns (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"show_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric show id (from ausha_list_shows)."
},
"q": {
"description": "Keyword(s) that filter the campaigns by name.",
"type": "string"
},
"page": {
"description": "Page number for pagination (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page (default 15).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"show_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_campaign(campaign_id)
Get one ad campaign by its numeric id. Ausha API: GET /v1/campaigns/{campaign} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the campaign."
}
},
"required": [
"campaign_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_list_podcasts(show_id, q, season_ids, statuses, page, ...)
List the episodes of a show. Filter by title keyword, season ids, or status (active, draft, scheduled). Ausha API: GET /v1/shows/{show}/podcasts (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"show_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric show id (from ausha_list_shows)."
},
"q": {
"description": "Search among episode titles.",
"type": "string"
},
"season_ids": {
"description": "Only episodes in these season ids (must belong to the show).",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"statuses": {
"description": "Only episodes with these statuses.",
"type": "array",
"items": {
"type": "string",
"enum": [
"active",
"draft",
"scheduled"
]
}
},
"page": {
"description": "Page number for pagination (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page (default 15).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"show_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_podcast(podcast_id)
Get one episode (podcast) by its numeric id. Ausha API: GET /v1/podcasts/{podcast} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"podcast_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the episode."
}
},
"required": [
"podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_podcast_by_public_id(public_id)
Get one episode by its public id (the id in its public URL). Ausha API: GET /v1/podcasts/public_id/{podcastByPublicId} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"public_id": {
"type": "string",
"minLength": 1,
"description": "Public id of the episode."
}
},
"required": [
"public_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_list_playlists(show_id)
List the playlists of a show with their privacy and episode count. Ausha API: GET /v1/shows/{show}/playlists (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"show_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric show id (from ausha_list_shows)."
}
},
"required": [
"show_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢ausha_get_playlist(playlist_id)
Get one playlist by its numeric id, with its episodes in order. Ausha API: GET /v1/playlists/{playlist} (Viewer).
Eingabe-Schema
{
"type": "object",
"properties": {
"playlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist."
}
},
"required": [
"playlist_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴ausha_create_playlist(show_id, name, privacy, password, slug, ...)
Create a playlist in a show. A private playlist needs a password. Creates data, so it is marked as a write. Ausha API: POST /v1/shows/{show}/playlists (Editor).
Eingabe-Schema
{
"type": "object",
"properties": {
"show_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric show id (from ausha_list_shows)."
},
"name": {
"type": "string",
"minLength": 3,
"maxLength": 140,
"description": "Playlist name (3 to 140 characters)."
},
"privacy": {
"description": "public (default), private or unlisted.",
"type": "string",
"enum": [
"public",
"private",
"unlisted"
]
},
"password": {
"description": "Required when privacy is private.",
"anyOf": [
{
"type": "string",
"maxLength": 255
},
{
"type": "null"
}
]
},
"slug": {
"description": "URL slug; must be unique.",
"type": [
"string",
"null"
]
},
"html_description": {
"description": "Description, as HTML (max 4000 characters).",
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
]
}
},
"required": [
"show_id",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡ausha_update_playlist(playlist_id, name, privacy, password, slug, ...)
Change a playlist's name, privacy, password, slug or description. Fields you omit stay as they are. Ausha API: PUT /v1/playlists/{playlist} (Editor).
Eingabe-Schema
{
"type": "object",
"properties": {
"playlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist."
},
"name": {
"description": "New name (3 to 140 characters).",
"type": "string",
"minLength": 3,
"maxLength": 140
},
"privacy": {
"description": "public, private or unlisted.",
"type": "string",
"enum": [
"public",
"private",
"unlisted"
]
},
"password": {
"description": "Password (required when privacy is private). null clears it.",
"anyOf": [
{
"type": "string",
"maxLength": 255
},
{
"type": "null"
}
]
},
"slug": {
"description": "New URL slug; must be unique. null clears it.",
"type": [
"string",
"null"
]
},
"html_description": {
"description": "New description, as HTML (max 4000 characters). null clears it.",
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
]
}
},
"required": [
"playlist_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴ausha_add_podcast_to_playlist(playlist_id, podcast_id)
Add one episode to a playlist. The episode must belong to the same show (otherwise HTTP 422). Ausha API: POST /v1/playlists/{playlist}/podcasts/{podcast} (Editor).
Eingabe-Schema
{
"type": "object",
"properties": {
"playlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist."
},
"podcast_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the episode."
}
},
"required": [
"playlist_id",
"podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡ausha_move_podcast_in_playlist(playlist_id, playlist_podcast_id, new_position)
Change the position of an episode inside a playlist. playlist_podcast_id is the id of the playlist-episode relation, not the episode id. Ausha API: PUT /v1/playlists/{playlist}/podcasts/{playlistPodcast} (Editor).
Eingabe-Schema
{
"type": "object",
"properties": {
"playlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist."
},
"playlist_podcast_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist-episode link."
},
"new_position": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "New position, starting at 0 (the first episode)."
}
},
"required": [
"playlist_id",
"playlist_podcast_id",
"new_position"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴ausha_remove_podcast_from_playlist(playlist_id, playlist_podcast_id)
Remove one episode from a playlist. playlist_podcast_id is the id of the playlist-episode relation, not the episode id. The episode itself is kept. Ausha API: DELETE /v1/playlists/{playlist}/podcasts/{playlistPodcast} (Editor).
Eingabe-Schema
{
"type": "object",
"properties": {
"playlist_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist."
},
"playlist_podcast_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the playlist-episode link."
}
},
"required": [
"playlist_id",
"playlist_podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis