search_anime
Pack: anilist · Endpoint: https://gateway.pipeworx.io/anilist/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_anime for the schema, then POST the same URL with its arguments for the data.
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.