# Goodreads MCP MCP > Goodreads MCP connects your AI agent to the world's largest book database for literature research and reading lists. Instantly search books, retrieve detailed metadata, build author bibliographies, and audit community reviews without leaving your client environment. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** book-search, literary-metadata, reading-lists, book-reviews, author-research, recommendations ## Description You can use this connector to make your AI agent act like a professional librarian. Instead of clicking through confusing web pages or juggling multiple databases, you talk to it naturally. Your agent retrieves specific book details, accesses full author biographies, and compiles user reviews and ratings into plain text summaries. This means whether you're writing academic research or just planning your next read, the data comes straight from one reliable source. When you connect this through Vinkius, your agent handles all that complex searching for you. It pulls metadata, tracks reading series, and even lists public user bookshelves, giving you a complete picture of literary history at your fingertips. ## Tools ### get_author_profile Retrieves detailed professional information about a specific author. ### get_book_info Gets the core metadata, such as title and description, for any book. ### get_series_metadata Gathers structural information about an entire series of books. ### get_user_public_profile Accesses public details from a Goodreads user's profile page. ### get_user_reviews Retrieves specific reviews written by users about books. ### get_user_shelves_list Lists the collection of books a user has marked as 'read' or 'to read'. ### list_author_books Generates a list of all titles written by a specific author. ### search_books Searches the entire database for books based on keywords or criteria. ## Prompt Examples **Prompt:** ``` Search for books by author 'Stephen King' and show me the list. ``` **Response:** ``` I've retrieved the book list for Stephen King from Goodreads. I found over 500 titles, including classics like 'The Shining', 'It', and 'Misery'. Would you like me to get the detailed metadata for a specific one? ``` **Prompt:** ``` Get the metadata and reviews summary for the book with ID '136251'. ``` **Response:** ``` I've retrieved the details for book ID `136251` ('Harry Potter and the Deathly Hallows'). It has an average rating of 4.62 from over 3 million users. Should I show you the most recent reviews for this title? ``` **Prompt:** ``` List all books in the 'Mistborn' series. ``` **Response:** ``` I've explored the 'Mistborn' series (ID: `40910`). The series contains the original trilogy plus subsequent entries like 'The Alloy of Law'. Would you like me to list them in their recommended reading order? ``` ## Capabilities ### Search the entire book catalog Find books across Goodreads by title or keyword search. ### Get detailed book specifications Retrieve specific metadata, like descriptions and formats, for any given book ID. ### Research an author's history Access a full biography and list all published works by an author. ### Analyze community sentiment on books Fetch and summarize user reviews and ratings for specific titles or authors. ### Map out book series chronologies List all books belonging to a known literary series, keeping the reading order intact. ## Use Cases ### A student researching a literary genre The student needs to understand the background of a specific author. They ask their agent to pull data using get_author_profile, then list all available books with list_author_books. The agent combines this into a single report showing the author's scope and influence. ### A marketer tracking competitor book interest The marketer wants to know which titles are getting buzz. They use search_books to find the main titles, then run get_user_reviews on those results. This reveals high-sentiment topics that could guide their next campaign. ### A reader planning a massive reading binge The user wants to read a trilogy but doesn't know the correct order. They ask for help with get_series_metadata, and the agent provides the full list in chronological sequence, preventing them from accidentally skipping a volume. ### A developer building an educational dashboard The developer wants to show book data alongside user activity. They pull general metadata with get_book_info and cross-reference it with the public profile details of users who reviewed it, providing a rich context layer. ## Benefits - Deep dive into authorship: Use the get_author_profile tool to gather a complete professional bio, so you don't have to search multiple websites for author context. - Sentiment analysis on demand: Run get_user_reviews to quickly gauge public opinion. This lets you see what readers actually think of a title before committing to content. - Organize large datasets: Need to know the proper order? The get_series_metadata tool maps out entire book series, keeping your reading logic sound. - Streamline discovery: Instead of browsing slowly, use search_books to pinpoint titles immediately. It's fast and keeps you focused on the data you need. - Track collections: You can list user bookshelves using get_user_shelves_list, giving you an overview of reading trends across communities. ## How It Works The bottom line is, you treat the entire Goodreads database like an extension of your AI client's memory. 1. Subscribe to this MCP and enter your Goodreads API credentials. 2. Connect your preferred AI client (like Claude or Cursor) to Vinkius. 3. Ask your agent a question, such as 'What are the best books in the Mistborn series?' The agent uses the tools to gather all metadata and present it. ## Frequently Asked Questions **How do I find out what a specific author wrote using list_author_books?** You provide the author's name or ID first. The tool then returns every title associated with that person, allowing you to build a complete bibliography for your project. **Can I get book details and user reviews using get_book_info and get_user_reviews?** Yes. You first use the book ID from get_book_info, and then pass that same ID to get_user_reviews to fetch specific community opinions on it. **What is the best way to research a series using get_series_metadata?** Simply provide the name of the book series. The tool handles grouping all related books and often presents them in recommended reading order, saving you from manual cross-checking. **Does get_user_public_profile show my personal bookshelf contents?** It shows general public profile data. For a list of books someone has marked as read or want to read, use the more specific get_user_shelves_list tool. **When I use get_author_profile, what credentials do I need to authenticate?** You must provide your dedicated Goodreads API Key and Secret during setup. The connection uses these credentials for every call to ensure secure access to your data streams. **How can I refine my search results when using the search_books tool?** The search_books tool supports filtering by specific parameters, such as publication year or genre. You pass these criteria directly into the request payload to narrow down the returned list. **If I use list_author_books, how do I get detailed metadata for every title found?** You must chain the tools: first run list_author_books to retrieve a batch of book IDs. Then, pass those resulting IDs into the get_book_info tool in a loop to gather full details. **What should I do if my calls to get_user_reviews fail due to rate limits?** Implement an exponential backoff strategy. If your agent receives a 429 error, pause execution for increasing intervals (e.g., 2s, then 4s, then 8s) before retrying the request.