Ausha MCP by usefulapi
Read shows, episodes and campaigns; manage playlists of episodes in Ausha.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen ausha_remove_podcast_from_playlist
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ausha": {
"url": "https://ausha.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://ausha.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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"
}Comunidad
Evidencia