Skip to content
Book ReviewsChaowalit Greepoke

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

ToolWhat it returnsArguments
get_reviewsList every book review, newest firstcategory (optional)
get_reviewGet one book review by slugslug
search_reviewsSearch titles, authors, categories and note textquery
get_categoriesList the categories used by the reviewsnone

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/call answer puts the data in result.reviews, result.review or result.categories, not in the content array that standard MCP clients expect.
  • There is no streaming or session support.