search_anime
Pack: anilist · Endpoint: https://gateway.pipeworx.io/anilist/mcp
Search for anime by title. Returns title, episode count, status, score, genres, and synopsis. Use get_anime with the ID for full details.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Anime title to search for, e.g. “Attack on Titan” or “Cowboy Bebop” |
limit | number | no | Number of results to return (1–25, default 10) |
Example call
Arguments
{
"query": "Attack on Titan"
}curl
curl -X POST https://gateway.pipeworx.io/anilist/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_anime","arguments":{"query":"Attack on Titan"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('search_anime', {
"query": "Attack on Titan"
});More examples
{
"query": "Cowboy Bebop",
"limit": 5
}Response shape
Always returns: count, results
| Field | Type | Description |
|---|---|---|
count | number | Number of results returned |
results | array | Array of anime search results |
Full JSON Schema
{
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Number of results returned"
},
"results": {
"type": "array",
"description": "Array of anime search results",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "AniList media ID"
},
"title_romaji": {
"type": [
"string",
"null"
],
"description": "Anime title in Romaji"
},
"title_english": {
"type": [
"string",
"null"
],
"description": "Anime title in English"
},
"title_native": {
"type": [
"string",
"null"
],
"description": "Anime title in native language"
},
"description": {
"type": [
"string",
"null"
],
"description": "Anime synopsis/description"
},
"episodes": {
"type": [
"number",
"null"
],
"description": "Total episode count"
},
"duration_minutes": {
"type": [
"number",
"null"
],
"description": "Episode duration in minutes"
},
"status": {
"type": [
"string",
"null"
],
"description": "Current status (FINISHED, AIRING, NOT_YET_AIRED, CANCELLED)"
},
"format": {
"type": [
"string",
"null"
],
"description": "Anime format (TV, MOVIE, OVA, ONA, SPECIAL)"
},
"source": {
"type": [
"string",
"null"
],
"description": "Original source (MANGA, LIGHT_NOVEL, VISUAL_NOVEL, etc)"
},
"season": {
"type": [
"string",
"null"
],
"description": "Season aired (SPRING, SUMMER, FALL, WINTER)"
},
"season_year": {
"type": [
"number",
"null"
],
"description": "Year of airing season"
},
"average_score": {
"type": [
"number",
"null"
],
"description": "Average community score (0-100)"
},
"mean_score": {
"type": [
"number",
"null"
],
"description": "Mean community score (0-100)"
},
"popularity": {
"type": [
"number",
"null"
],
"description": "Popularity ranking"
},
"favourites": {
"type": [
"number",
"null"
],
"description": "Number of times added to favorites"
},
"genres": {
"type": "array",
"description": "List of genres",
"items": {
"type": "string"
}
},
"cover_image": {
"type": [
"string",
"null"
],
"description": "URL to cover image"
},
"site_url": {
"type": [
"string",
"null"
],
"description": "AniList page URL"
},
"studios": {
"type": "array",
"description": "List of animation studio names",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"title_romaji",
"title_english",
"title_native",
"description",
"episodes",
"duration_minutes",
"status",
"format",
"source",
"season",
"season_year",
"average_score",
"mean_score",
"popularity",
"favourites",
"genres",
"cover_image",
"site_url",
"studios"
]
}
}
},
"required": [
"count",
"results"
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"anilist": {
"url": "https://gateway.pipeworx.io/anilist/mcp"
}
}
}See Getting Started for client-specific install steps.