For developers and AI agents
MCP API
Book Reviews answers a small, MCP-style JSON-RPC 2.0 API at /api/mcp. It is read-only, needs no key, and returns the same content this site shows.
Call it
Send a POST with a JSON-RPC body. A plain browser visit (GET) is not supported.
curl -s https://bookreviews.bookchaowalit.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Then call a tool by name with its arguments:
curl -s https://bookreviews.bookchaowalit.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_reviews","arguments":{}}}'Tools
| Tool | What it returns | Arguments |
|---|---|---|
get_reviews | List every book review, newest first | category (optional) |
get_review | Get one book review by slug | slug |
search_reviews | Search titles, authors, categories and note text | query |
get_categories | List the categories used by the reviews | none |
The methods initialize, tools/list and tools/call are supported; anything else returns a JSON-RPC error.
Not a full MCP server
This is a custom subset of the Model Context Protocol, made for curl and simple scripts. An off-the-shelf MCP client may reject the replies:
- A
tools/callanswer puts the data inresult.reviews,result.revieworresult.categories, not in thecontentarray that standard MCP clients expect. - There is no streaming or session support.