API v2.5.0Read-only
Knowledge API & MCP
Machine-readable access for AI agents and developers. Search verified visitor Q&A with no API key.
Overview
The Bonanza knowledge base exposes REST JSON and MCP tool descriptors. Authority stays on-site canonical URLs; third-party sources are not published in API responses.
- Base URL:
https://peaktramhk.com - Articles: 150 (10 categories)
- MCP:
search_knowledge,get_article
Quick start
- Read the discovery index: llms-knowledge.txt
- Search articles:
curl "https://peaktramhk.com/api/knowledge?q=parking&lang=en" - Fetch one article as Markdown:
curl "https://peaktramhk.com/api/knowledge/tour-bus-rv-parking?format=md&lang=en"
Authentication
Public read-only endpoints. No API key required. Respect usage limits below.
REST endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/knowledge | Full index or ?q= search |
| GET | /api/knowledge/{id} | JSON article |
| GET | /api/knowledge/{id}?format=md | Markdown export |
| GET | /api/knowledge/mcp | MCP descriptor |
Params: q, lang (en|zh), format (md)
MCP tools
Server card: /.well-known/mcp/server-card.json
search_knowledge
Keyword search across the KB (parking, hours, shipping, etc.).
get_article
Fetch one article by id as JSON or Markdown.
Discovery
Rate limits
Stay under ~2 requests per second with spacing between cached responses. Use async patterns for batch jobs and avoid peak traffic.
Errors
- 200 — OK
- 404 — Unknown article id