{"$schema":"https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/server-card.json","serverInfo":{"name":"KingdomOfBooks Catalog","version":"1.0.0","description":"Browse and search the KingdomOfBooks Arabic/English bookstore catalog: books, categories, authors, publishers, bundles, and reviews."},"transport":{"type":"webmcp","endpoint":"https://api.kingdomofbook.com/agent"},"capabilities":{"tools":[{"name":"search_books","description":"Search and browse the KingdomOfBooks catalog with filtering, sorting, and pagination. Returns books with title, author, price (localized), cover image URL, ISBN, format availability (physical/digital/voice), and categories.","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Free-text search across book title and description."},"categoryId":{"type":"integer","description":"Filter by category ID."},"authorId":{"type":"integer","description":"Filter by author ID."},"publisherName":{"type":"string","description":"Filter by publisher name."},"coverType":{"type":"integer","description":"Filter by cover type (e.g., 0 = Hardcover, 1 = Paperback)."},"language":{"type":"integer","description":"Filter by language code (enum int)."},"sort":{"type":"string","enum":["NameAsc","NameDesc","PriceAsc","PriceDesc","DateDesc","DateAsc"],"description":"Sort order for results."},"isLatest":{"type":"boolean","description":"Filter to only books flagged as latest."},"isMostSelling":{"type":"boolean","description":"Filter to only best-selling books."},"pageIndex":{"type":"integer","minimum":1,"description":"Page number (1-based).","default":1},"pageSize":{"type":"integer","minimum":1,"maximum":200,"description":"Page size (max 200).","default":10}},"required":[]}},{"name":"get_book","description":"Get full details for a single book by ID. Returns title (Arabic + English), description, price (localized + USD), cover image URL, ISBN, page count, format availability, stock, categories, authors, publisher, and average rating.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"The book ID."}},"required":["id"]}},{"name":"get_most_selling_books","description":"List best-selling books with pagination. Same response shape as search_books.","inputSchema":{"type":"object","properties":{"pageIndex":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":200,"default":10}},"required":[]}},{"name":"get_categorized_books","description":"Get books grouped by category for the store home page. Returns each category with up to 5 books.","inputSchema":{"type":"object","properties":{},"required":[]}},{"name":"get_book_reviews","description":"Get paginated customer reviews for a book. Each review includes rating (1-5), review text, and reviewer user name.","inputSchema":{"type":"object","properties":{"bookId":{"type":"integer","description":"The book ID to fetch reviews for."},"pageIndex":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":200,"default":10}},"required":["bookId"]}},{"name":"list_categories","description":"List book categories with optional search and pagination. Each category has ID, name (Arabic + English), and home-page appearance flags.","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Filter categories by name."},"appearInHomePage":{"type":"boolean","description":"Filter to categories shown on home page."},"pageIndex":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":200,"default":10}},"required":[]}},{"name":"get_category","description":"Get a single category by ID.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"The category ID."}},"required":["id"]}},{"name":"list_authors","description":"List book authors with optional search and pagination. Each author has ID, name (Arabic + English), description, and profile picture URL.","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Filter authors by name."},"pageIndex":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":200,"default":10}},"required":[]}},{"name":"get_author","description":"Get a single author by ID, including their profile picture URL and biography (Arabic + English).","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"The author ID."}},"required":["id"]}},{"name":"list_publishers","description":"List book publishers with optional search and pagination. Each publisher has ID and name (Arabic + English).","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Filter publishers by name."},"pageIndex":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":200,"default":10}},"required":[]}},{"name":"get_publisher","description":"Get a single publisher by ID.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"The publisher ID."}},"required":["id"]}},{"name":"list_bundles","description":"List product bundles (curated book collections with discounts) with optional search and filtering by book ID. Each bundle has a name, description, date range, active flag, and items (each item references a book with discount).","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Filter bundles by name."},"bookId":{"type":"integer","description":"Filter to bundles containing a specific book."},"pageIndex":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":1,"maximum":50,"default":10}},"required":[]}},{"name":"get_bundle","description":"Get a single bundle by ID, including all items and their associated books.","inputSchema":{"type":"object","properties":{"id":{"type":"integer","description":"The bundle ID."}},"required":["id"]}}]}}