Agent API & MCP

Build agentic workflows with Books Mandala's live catalog of 50,000+ books. Our REST API and MCP let AI agents search, browse, and discover books with real-time pricing and stock availability — designed for seamless integration with Claude, ChatGPT, Cursor, and any MCP-compatible AI client.

MCP

If you use an MCP-compatible AI app like Claude Desktop, Cursor, or Windsurf, you can connect to Books Mandala in seconds. No API key needed.

MCP Endpoint

https://bm-agent-mcp.booksmandala.workers.dev/mcp

Claude Desktop Setup

Add this to your Claude Desktop config file:

{
  "mcpServers": {
    "books-mandala": {
      "url": "https://bm-agent-mcp.booksmandala.workers.dev/mcp"
    }
  }
}

Restart Claude Desktop after adding. Then ask it about any book!

7 Tools Available

search_booksSearch by title, author, or ISBN

get_bookFull details for a specific book

list_genresBrowse all 177 genres

browse_genreBooks within a specific genre

bestsellersCurrent bestselling books

new_arrivalsRecently added titles

get_authorAuthor profile and their catalog

REST API

For developers building custom integrations, bots, or applications. Full REST API with complete specification and documentation.

Base URLhttps://booksmandala.com/api/agent/v1

AuthenticationAPI key via X-API-Key header

Rate Limit100 requests/minute per key

FormatJSON with plain text descriptions

Endpoints

Endpoint	Description
`GET /search?q=...`	Search books by title, author, or ISBN
`GET /books/{isbn-or-slug}`	Get full book details
`GET /genres`	List all 177 genres
`GET /genres/{slug}/books`	Browse books in a genre
`GET /bestsellers`	Current bestselling books
`GET /new-arrivals`	Recently added titles
`GET /authors/{slug}`	Author info and their books
`GET /docs`	Full API specification (machine-readable)

Full API specification: booksmandala.com/api/agent/v1/docs

Get an API Key

API keys are free for non-commercial use. To request a key, email [email protected] with a brief description of how you plan to use the API.

AI Discovery

Books Mandala provides machine-readable files for AI systems to discover our catalog and API.

llms.txtSummary for AI systems

llms-full.txtDetailed catalog and API documentation

ai-plugin.jsonOpenAI plugin manifest

OpenAPI SpecFull API specification (JSON)

Roadmap

We're building toward a fully agentic bookstore where AI agents can do everything a human customer can.

Phase 1Discovery & BrowsingLive

Phase 2Real-time stock, shipping estimates, price alertsComing Soon

Phase 3Order placement, payment links, delivery trackingPlanned

Phase 4Personalized recommendations, wishlists, reordersFuture

Open Source

The MCP server source code is open source on GitHub.

github.com/mandalatech/bm-agent-mcp