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://chargingbullnewyork.com
Articles: 150 (10 categories)
MCP: search_knowledge, get_article

Quick start

Read the discovery index: llms-knowledge.txt
Search articles: curl "https://chargingbullnewyork.com/api/knowledge?q=parking&lang=en"
Fetch one article as Markdown: curl "https://chargingbullnewyork.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

Agent feed

Copy JSON or call the APIs below. No HTML scraping required.

GET /api/knowledge?q=

GET /api/knowledge/mcp

GET /llms-knowledge.txt

MCP descriptor →

Sample response · q=parking

{
  "version": "2.5",
  "query": "parking",
  "total": 3,
  "results": [
    {
      "id": "parking-options-near-charging-bull",
      "question": "What parking options are available near the Charging Bull statue?",
      "answer": "Use Financial District garages within a 5-minute walk",
      "url": "https://chargingbullnewyork.com/en/knowledge/parking-options-near-charging-bull"
    },
    {
      "id": "parking-garages-bowling-green-financial-district",
      "question": "What are the parking options near the Charging Bull in Bowling Green?",
      "answer": "Greenwich Street and West Street garages are closest",
      "url": "https://chargingbullnewyork.com/en/knowledge/parking-garages-bowling-green-financial-district"
    },
    {
      "id": "parking-options-near-bowling-green",
      "question": "What parking options are available near Bowling Green and the Charging Bull?",
      "answer": "Nearby Financial District garages; avoid distant Seaport/Pier 40",
      "url": "https://chargingbullnewyork.com/en/knowledge/parking-options-near-bowling-green"
    }
  ]
}

Discovery chain

llms-knowledge.txt
/.well-known/api-catalog
/api/knowledge/mcp
/api/knowledge?q=

Human hub: /en/knowledge