# Kitsu MCP

> Kitsu MCP lets you manage your anime and manga collections directly from any AI agent. Browse thousands of titles, check user profiles, and update your personal tracking lists—all without leaving your chat client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** anime, manga, library-tracking, kitsu-api, media-database

## Description

Connect Kitsu to your preferred AI client to explore the world of anime and manga using natural conversation. Need to find a new series? You can search through thousands of titles by category or year. Want to keep track of what you're reading? You manage your personal library, adding new entries or updating progress on existing ones. It’s about making your media tracking list an active part of your workflow. If you use Vinkius, this MCP fits right alongside other tools that handle structured data, letting your agent access not just the metadata, but your actual reading history. You get a single source for both discovery and organization.

## Tools

### create_library_entry
Adds a brand new title to your personal tracking collection.

### get_anime
Fetches all detailed information available for a specific anime series.

### get_current_user
Retrieves the profile data associated with your logged-in account.

### get_manga
Fetches all detailed information available for a specific manga series.

### get_user
Gets the profile data for any specified user account.

### list_anime
Searches and lists anime series using specific filters like year, season, or category.

### list_library_entries
Shows a list of every title currently in your personal library tracking list.

### list_manga
Searches and lists manga series using specific filters to narrow down results.

### update_library_entry
Changes the status or details of a title already in your library tracking list.

## Prompt Examples

**Prompt:** 
```
Search for action anime from the Summer 2023 season.
```

**Response:** 
```
I found several action anime from Summer 2023, including 'Jujutsu Kaisen Season 2' and 'Zom 100: Bucket List of the Dead'. Would you like more details on any of these?
```

**Prompt:** 
```
Get the details for anime with ID 12.
```

**Response:** 
```
Fetching details for ID 12... That is 'One Piece'. It's an ongoing series about Monkey D. Luffy's quest to become the Pirate King. It has over 1000 episodes and is categorized under Action, Adventure, and Fantasy.
```

**Prompt:** 
```
Show me my library entries.
```

**Response:** 
```
I've retrieved your library. You have 15 entries, including 'Chainsaw Man' (Currently Watching) and 'Berserk' (Completed). Would you like to update the progress for any of these?
```

## Capabilities

### Discover titles
Search massive databases of anime or manga using filters like genre, season, or year.

### Retrieve detailed metadata
Get full descriptions and production facts for any specific series by ID or name.

### Manage your personal collection
Add new titles to your tracking list, update progress (e.g., 'currently reading'), or review existing entries.

### View user data
Access profile information for yourself or other users on the platform.

## Use Cases

### Curating a Watchlist
A fan asks their agent: 'I need all action anime released in Summer 2023.' The agent uses `list_anime` to filter by both genre and season, immediately providing the user with actionable titles they can review or add.

### Cross-Referencing Data
A content creator needs background on a specific series. They use their agent to `get_manga` details for a title, pulling out production notes and genres, which they then paste directly into a script draft.

### Auditing Progress
A user wants to check if they completed a specific series. They run `list_library_entries`, instantly seeing their progress status for every title they've added, and can then use the MCP to update that status.

### Building a Database Feed
A developer needs bulk data for an internal app. They run `list_anime` multiple times with different filters (e.g., 'Fantasy' by year, then 'Sci-Fi' by season) to gather structured datasets that can be imported.

## Benefits

- Finding titles is fast. Instead of clicking through multiple search tabs, you can ask your agent to `list_anime` or `list_manga`, filtering by season or genre instantly.
- Your library stays accurate. You don't have to manually remember every status update; use the tool to `update_library_entry` and keep your progress tracked.
- Metadata is instant. Need details on a show? The MCP lets you `get_anime` or `get_manga`, pulling out descriptions and genres in one go for research.
- Profile management happens automatically. You can use `get_user` to check specific accounts, or `get_current_user` to verify your own credentials without leaving the chat.
- Library building is simple. When you find a great read, just run `create_library_entry` and add it directly from the prompt.

## How It Works

The bottom line is that your AI client handles the back-and-forth with Kitsu, so you just talk to it naturally.

1. First, you subscribe to this MCP and provide your Kitsu Access Token.
2. Next, you tell your agent exactly what you want—for example, 'Show me all sci-fi manga I started last year.'
3. Your agent sends the request using the appropriate tool (like `list_manga`) and returns structured data about the titles.

## Frequently Asked Questions

**How do I use the Kitsu MCP to find new shows?**
Use `list_anime` and tell your agent what filters you need. You can specify categories, seasons, or years in a single prompt for fast results.

**Does `create_library_entry` require me to know the ID?**
No, you just ask your agent to add it by title and genre. The MCP handles passing all necessary parameters so that the entry is created correctly in your list.

**Can I get details on a specific manga? Which tool should I use?**
You must use `get_manga`. This function accepts an identifier and returns comprehensive information, including descriptions and genres, for that single series.

**If I change my status, do I need to call a specific tool like `update_library_entry`?**
Yes. While you can talk about it, the system needs the explicit function call. You ask your agent to update it, and it uses `update_library_entry` behind the scenes.

**When I use the `get_current_user` tool, what information does it pull about my account?**
It immediately returns your profile details. This includes basic info like your username and ID, letting you confirm which account is connected to your AI client.

**How do I use the `list_library_entries` tool if I need a full overview of my collection?**
The tool pulls every single entry in your personal tracking list. You get a clean, comprehensive rundown of all your anime and manga entries at once.

**If I already know the ID of an anime, should I use `get_anime` instead of searching?**
Yes, using `get_anime` is faster. Since you have the exact identifier, it skips the search process and delivers all the specific metadata immediately.

**What if I want to see another person's profile? Do I use the `get_user` tool?**
That's right. You pass a user ID, and `get_user` retrieves all public details for that specific account on Kitsu.

**Can I search for anime by specific seasons or years?**
Yes! The `list_anime` tool allows you to filter by `filter_season` (winter, spring, summer, fall) and `filter_year` (e.g., 2023 or a range like 2010..2020).

**How do I see what's currently in my library?**
You can use the `list_library_entries` tool with your `user_id`. If you don't know your ID, run `get_current_user` first to retrieve your profile details.

**Can I update my progress on a manga I'm reading?**
Absolutely. Use the `update_library_entry` tool to modify the status or progress of any existing entry in your library.