Developers · MCP

Hoedspruit Destination MCP

A read-only, machine-readable destination server for Hoedspruit and the Greater Kruger. Backed by the same verified dataset that powers hoedspruit.co.za — directory and MCP never disagree.

Endpoint: https://mcp.hoedspruit.co.za/
Protocol: MCP Streamable HTTP · JSON-RPC 2.0
protocolVersion: 2025-03-26
Server version: 2.0.0
Methods: initialize · tools/list · tools/call · ping
CORS: Open (read-only)

Tools

hoedspruit_search

Search accommodation, restaurants, activities, attractions, businesses, and services in the Hoedspruit area (Greater Kruger, Limpopo, South Africa). Returns name, category, contact, coordinates and description. Filter by category.

Args: query (string, required), category, limit (default 10, max 20), include_details

hoedspruit_get_place

Get detailed information about a specific place in Hoedspruit by slug or ID. Returns full description, contact, amenities, hours, pricing, ratings, booking links and GPS.

Args: identifier (string, required) — slug (e.g. "aerotel-hoedspruit") or numeric ID

hoedspruit_nearby

Find places near GPS coordinates in the Hoedspruit area. Uses Haversine distance. Sorted by distance.

Args: latitude (required), longitude (required), radius_km (default 10, max 80), category, limit

hoedspruit_weather

Current weather and 7-day forecast for Hoedspruit. Temperature, humidity, wind, precipitation, UV index, sunrise/sunset. Includes seasonal malaria risk indicator.

Args: include_forecast (default true)

hoedspruit_events

Upcoming events, festivals, markets and activities. Filter by category and date range. (Currently returns empty until wah_content adds event-date columns — endpoint stays in tools/list for spec stability.)

Args: category, from_date (YYYY-MM-DD), to_date, query, limit

hoedspruit_wildlife

Search wildlife species found in the Hoedspruit and Greater Kruger area. Returns species info, conservation status, Big 5 flag, viewing locations.

Args: query (required), group, limit

hoedspruit_practical

Practical travel info: getting here, getting around, health, climate, money, packing, Kruger gates and fees. Cross-references the related FAQs.

Args: query (required), category, limit (default 5, max 10)

hoedspruit_directory

Business directory: veterinarians, plumbers, attorneys, estate agents, contractors, banks, petrol stations, car hire, etc. Returns business name, contact, address, hours.

Args: query (required), category, limit

Example call

Get a place by slug:

curl -X POST https://mcp.hoedspruit.co.za/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "hoedspruit_get_place",
      "arguments": {"identifier": "aerotel-hoedspruit"}
    }
  }'

Single source of truth

The MCP, the JSON API (/api/v1/listing/{slug}), and every page on hoedspruit.co.za all answer from the same wah_listings + wah_content tables. A consistency gate (scripts/consistency-check.mjs) asserts MCP ↔ API ↔ page ↔ DB row on a 20-slug sample on every release. The most recent run passed 20/20.

Auth, rate limits and attribution

All read tools are open. Future write tools (claim, edit) will require auth.
Rate limiting is layered at the CDN; current limits are 50 calls/day free, 5,000/day premium.
google_rating is never surfaced — Wild About Hoedspruit grades and reviewer bylines are the citation signal.
Apify-source listings whose verification has not reached team_enriched ship with first-party fields only (name, category, area, contact, map) — scraped editorial is suppressed.
Attribution: “Source: Wild About Hoedspruit (hoedspruit.co.za) — The definitive Hoedspruit destination guide.”

MCP Registry

Listed on the official Model Context Protocol Registry for AI client discovery. The submission lives at data/com.hoedspruit/destination-mcp.yaml .

Questions or to claim a listing: contact us.