# Kavita (eBook/Manga) MCP for AI Agents AI Agent Connect > Kavita (eBook/Manga) lets you manage your personal media library directly through your AI agent. It handles the heavy lifting of scanning for new content, checking your API keys, and managing authentication. Whether you're organizing a massive manga collection or a personal eBook library, this Connector puts your Kavita instance under your agent's control so you can manage everything via chat. ## Overview - **Category:** content-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_WONVebpmVAwycBtoOVP2Y5mViGz39apGdZ4wI5Pc/ai-agent-connect - **Tags:** ebooks, manga, media-server, library-management, kavita ## Description This connector lets you manage your Kavita media library directly through your AI agent. Imagine you just finished downloading a batch of new manga chapters and want them to show up in your library immediately. Instead of opening a browser, logging into your web interface, and clicking through menus to trigger a manual refresh, you just tell your AI agent to do it. This Connector acts as the bridge between your AI client and your Kavita instance. It gives your agent the specific permissions it needs to talk to your Kavita instance. You can ask it to check if your API keys are about to expire or have it run a full scan on your entire collection. It's like having a digital librarian who knows exactly where everything is and keeps the shelves updated for you. By adding this to your setup in the Vinkius catalog, you move away from clicking through buttons and move toward just asking for what you need. It handles the authentication tokens and the specific scan commands for you. You get a hands-off way to keep your digital library organized, making sure your latest reads are always ready when you are. ## Tools ### check_authkey_expires See how much time is left on your API key. This helps you stay ahead of access issues. ### authenticate Get a secure JWT token for your session. This allows your agent to perform actions on your behalf. ### scan_all_libraries Tell the agent to refresh every single library in your collection. This ensures all new content is caught. ### scan_library Pick one specific library to update. This is great for when you only just added a few new files to one folder. ## Prompt Examples **Prompt:** ``` Scan my manga library for new chapters. ``` **Response:** ``` I've started a scan on your manga library. Your agent is checking the folders now to see if any new files have appeared. ``` **Prompt:** ``` Is my API key still good? ``` **Response:** ``` I've checked your Kavita status. Your current API key is valid until December 31, 2025, so you're all set for now. ``` **Prompt:** ``` Refresh everything. ``` **Response:** ``` I'm triggering a global scan of all your libraries. This will update your entire collection of ebooks and manga at once. ``` ## Capabilities ### Trigger a full library scan Tell your agent to refresh every single library in your collection at once. ### Scan a specific library by ID Target a single library for an update when you only need to index one folder. ### Check API key expiration dates See how much time is left on your credentials to prevent access issues. ### Authenticate and get JWT tokens Get a secure session token so your agent can perform actions on your behalf. ### Automate library maintenance Keep your collection updated without leaving your current workspace. ## Use Cases ### Instant Manga Indexing A collector finishes a big download and asks the agent to scan library 5 so they can start reading the new chapters immediately. ### API Health Check A user notices their agent is failing to connect and asks it to check the API key status to see if it needs a refresh. ### Weekly Library Maintenance A self-hoster tells the agent to scan all libraries every Sunday night to ensure everything is indexed and updated. ### Automated Session Handling A developer uses the authenticate tool to grab the necessary JWT tokens for their own custom scripts or dashboards. ## Benefits - Stop clicking buttons in the web UI by using scan_all_libraries to refresh your entire collection instantly. - Avoid sudden access blocks by using check_authkey_expires to keep your API credentials valid at all times. - Keep your agent's connection secure and active with the authenticate tool for smooth session management. - Save time on large updates by using scan_library to target only the specific folders you just updated. - Get a hands-off experience where your agent handles the technical details of Kavita for you. - Ensure your latest reads are always ready by automating the indexing of new manga and ebook files. ## How It Works The bottom line is you get a chat-based interface to manage your Kavita media library without touching the web UI. 1. Subscribe to the Kavita (eBook/Manga) MCP on Vinkius. 2. Enter your Kavita URL and API Key into your AI client's configuration. 3. Ask your agent to scan for new books or check your library status. ## Frequently Asked Questions **What does the Kavita (eBook/Manga) MCP actually do?** It lets you manage your Kavita media library directly through your AI agent. You can trigger scans and check your API status without using a web browser. **Can I use Kavita (eBook/Manga) to scan for new manga?** Yes, you can ask your agent to scan for new content in your specific manga libraries or refresh your entire collection at once. **How do I check if my Kavita API key is expiring?** You can just ask your agent to check your API status. It will retrieve the expiration date from your Kavita instance and tell you how much time is left. **Does Kavita (eBook/Manga) help with library organization?** It helps with maintenance by automating the scanning process and managing your session tokens, ensuring your library stays up to date. **Is Kavita (eBook/Manga) for public libraries?** No, this Connector is designed for personal self-hosted instances of the Kavita media library for your own private collection. **Can I use Kavita (eBook/Manga) to read my books?** No, this is a management tool for scanning and status checks. It doesn't provide a way to read the content directly in the chat. **Can I trigger a scan for just one specific library?** Yes! Use the `scan_library` tool and provide the specific Library ID. The agent will trigger a targeted scan to detect new or changed content in that folder only. **How do I check if my API key is still valid?** You can run the `check_authkey_expires` tool. It will return the exact expiration timestamp for your current API key, helping you avoid service interruptions. **Can I refresh my entire collection at once?** Absolutely. Use the `scan_all_libraries` tool to trigger a global scan across all configured libraries in your Kavita instance.