The Bonai News API ships with a Model Context Protocol (MCP) server. You can connect it to AI assistants like Claude Desktop, Cursor, or opencode to search news, fetch articles, and discover trending topics directly from your assistant.
Requirements
MCP access must be enabled on your plan. Requests to /mcp that don’t have the entitlement return 403.
Endpoint
The server uses streamable HTTP in JSON mode:
POST /mcp: JSON-RPC messages, including initialize, tools/list, and tools/call.GET /mcp: opens the optional server-sent events stream. The server runs stateless, so clients can use POST alone.
Authenticate with the same API key you use for the REST API, as a bearer token (Authorization: Bearer) or in the api-key / x-api-key header. You can also send api-version to pin a specific API version.
The server exposes seven tools:
Point your client at the endpoint with your API key as a header. For example, in Claude Desktop’s claude_desktop_config.json:
In opencode’s opencode.json:
Billing
Each tools/call message consumes one quota unit from your plan. The session handshake and tools/list calls are free.
Keep your API key out of shared configuration files and source control. Use environment variables or a secret manager in production.
