Skip to content
News DeskSample edition

For developers and AI agents

MCP API

News Desk 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://news-aggregator.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://news-aggregator.bookchaowalit.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_stories","arguments":{}}}'

Tools

ToolWhat it returnsArguments
list_storiesList the sample edition's stories, optionally for one beatcategory (optional)
get_storyGet one sample story by idid
search_storiesSearch headlines, summaries, sources and beatsquery

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.stories or result.story, not in the content array that standard MCP clients expect.
  • There is no streaming or session support.