# AniList GraphQL MCP

> AniList GraphQL connects your AI agent directly to the world's largest anime and manga database. Search for titles, characters, staff members, and studios instantly. It lets you retrieve detailed metadata, check airing schedules, and manage personal media lists without ever leaving your chat or IDE.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** anime, manga, graphql, otaku-database, media-tracking

## Description

Need deep data on anime and manga? This MCP connects your AI agent to the massive AniList GraphQL database. You can query for any title—from searching a specific series using `search_media` to fetching all its detailed metadata with `get_media`. It also lets you dive into who made the content, pulling up full profiles for characters or staff members using dedicated tools like `get_character` and `get_staff`. Beyond viewing data, you can manage your personal tracking by creating or updating entries in your media lists via `save_media_list_entry`, or even removing them with `delete_media_list_entry`. If you need to know who's behind the art, it tracks studios through `get_studio` profiles. For developers and content creators, this is a huge time saver; instead of cross-referencing ten different websites, your agent pulls everything together from one source. You can connect this powerful data source easily via any MCP client available on Vinkius.

## Tools

### delete_media_list_entry
Removes an item from your personal anime or manga watch list.

### get_airing_schedule
Checks and reports the current broadcast schedule for a specific media title.

### get_character
Pulls up detailed information, including roles and voice actors, for one character.

### get_media
Retrieves all available metadata about a specific anime or manga series.

### get_staff
Gets detailed information on an individual staff member, like a director or writer.

### get_studio
Provides background and history details for a specific animation studio.

### get_user
Fetches public profile information belonging to a specified user.

### get_viewer
Retrieves the currently authenticated user's details without needing an ID.

### save_media_list_entry
Adds or updates a title entry in your personal media watchlist.

### search_characters
Finds characters across the database based on names or descriptions.

### search_media
Searches the entire database for anime or manga titles using keywords.

### search_staff
Searches for professional staff members by name or role.

### toggle_favourite
Marks a title as a favorite or un-favorites it in your list.

### toggle_follow
Changes whether or not you are following another user's activity.

### update_user
Allows you to modify specific settings on your personal AniList account profile.

## Prompt Examples

**Prompt:** 
```
Search for the anime 'Cowboy Bebop' and show its details.
```

**Response:** 
```
I found 'Cowboy Bebop' (ID: 1). It's a classic Sci-Fi/Action series by Sunrise. Would you like to see the full character list or the airing history?
```

**Prompt:** 
```
Who is the character 'L' from Death Note?
```

**Response:** 
```
Using `get_character`, I found L Lawliet. He is a world-renowned detective who takes on the challenge of catching the serial killer known as Kira. Would you like to see his voice actors?
```

**Prompt:** 
```
Show me information about the animation studio MAPPA.
```

**Response:** 
```
I've retrieved the data for Studio MAPPA (ID: 569) using `get_studio`. They are known for works like 'Jujutsu Kaisen' and 'Attack on Titan: The Final Season'.
```

## Capabilities

### Search for media titles
Find anime or manga series by name or genre using the search functions.

### Retrieve detailed media metadata
Get comprehensive information, including airing schedules and summaries, for a specific title.

### Gather character profiles
Pull up full bios and related data for any listed anime or manga character.

### Query staff members and studios
Find information on directors, voice actors, and animation studios responsible for a title.

### Manage personal tracking lists
Create new entries or modify existing ones in your personalized media watchlists.

## Use Cases

### Writing a deep-dive review on anime production.
A content creator needs to write about the animation quality of 'Jujutsu Kaisen'. Instead of searching for the studio, then finding its history, they prompt their agent. The agent uses `get_studio` and `get_staff` tools to pull together the necessary data on MAPPA's track record in one go.

### Tracking a show you want to binge-watch.
You just finished 'Cowboy Bebop' and want to add it to your history. You tell your agent, 'Add this series to my list.' The agent uses `save_media_list_entry` immediately, tracking the title for you.

### Validating a character name for a database.
A game developer is building lore and finds an obscure character. They ask their agent to check the character's details. The agent uses `search_characters` and then `get_character` to confirm the existence, roles, and associated staff.

### Checking a show's broadcast status.
You want to know if your favorite manga adaptation is airing soon. You ask, 'What's the next episode date for this series?' The agent runs `get_airing_schedule` and gives you the exact dates.

## Benefits

- You stop wasting time switching tabs. Instead of visiting the AniList site, your agent pulls all media details—like a title's full metadata via `get_media`—directly into your chat window.
- Personal list management becomes instant. You can add or remove shows using `save_media_list_entry` without ever navigating to a watchlist page yourself.
- When you need context for a character in an article, the agent gets it instantly with `get_character`, providing bios and related staff details all at once.
- You can check production history by looking up studios using `get_studio`. It's faster than cross-referencing Wikipedia articles to know who made what.
- The system handles complex searches. Need names? Use `search_media` or `search_staff`; it finds the right data point instantly, no guessing needed.

## How It Works

The bottom line is: your AI client treats this database like a native function, letting you ask complex questions without needing to manually navigate web forms.

1. First, you subscribe to this MCP and enter your AniList Access Token if the data needs to be private (like personal lists).
2. Next, you prompt your agent with a query—for example, 'What's the director of Studio MAPPA?'
3. Your agent sends that request through the connection, and it gets back structured data like character bios or airing schedules.

## Frequently Asked Questions

**How do I check an anime's schedule using AniList GraphQL MCP?**
You use the `get_airing_schedule` tool to query the current broadcast dates for a specific title. This gives you up-to-date timing information directly from the database.

**Can I add an anime to my list with AniList GraphQL MCP?**
Yes, use `save_media_list_entry`. You simply tell your agent which title and what status you want it set to, updating your watchlist immediately.

**What if I only know a character's name? Can AniList GraphQL MCP find them?**
You can use `search_characters` first to confirm the character exists and get their ID. Then, you run `get_character` for full details.

**Does AniList GraphQL MCP handle manga data too?**
Absolutely. The database covers both anime series and manga titles. You can use tools like `search_media` to find either format of media.

**I want to update my user profile using AniList GraphQL MCP.**
Use the `update_user` tool. Your agent will guide you through what specific settings you need to change on your account.