For developers and AI agents
MCP API
Reading Shelf 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://reading.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://reading.bookchaowalit.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_all","arguments":{}}}'Tools
| Tool | What it returns | Arguments |
|---|---|---|
get_all | List every item on the reading shelf | none |
get_by_id | Get one reading item by id | id |
search | Search titles, summaries and categories | query |
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. A tools/call answer puts the data in result.items or result.item, not in the content array that standard MCP clients expect, and there is no streaming or session support, so an off-the-shelf MCP client may reject the replies.