# GroundTruthData

> GroundTruthData is a paid MCP server that gives Claude, ChatGPT and other AI assistants cited, aggregated facts about South African places: crime, rainfall, population and boundaries, with source, licence and date on every number.

GroundTruthData is operated by BI Branch (Pty) Ltd. It is a paid remote MCP server: bounded tools return aggregated, cited answers, never bulk data. Every figure carries its source, licence, retrieval date and dataset version.

MCP endpoint: https://mcp.groundtruthdata.co.za/mcp. Each page below is also served as Markdown at the same path with a .md extension.

## Docs

- [Introduction](https://groundtruthdata.co.za/docs.md): GroundTruthData gives AI assistants cited, aggregated facts about South African places through the Model Context Protocol (MCP).
- [How GroundTruthData works](https://groundtruthdata.co.za/docs/how-it-works.md): A plain-English overview of where the numbers come from and how your AI assistant gets cited answers.
- [Quickstart](https://groundtruthdata.co.za/docs/quickstart.md): Connect GroundTruthData to Claude, ChatGPT, Cursor or any MCP client.
- [Authentication](https://groundtruthdata.co.za/docs/authentication.md): OAuth 2.1 for connectors, Bearer API keys for agents and scripts.
- [Plans and limits](https://groundtruthdata.co.za/docs/limits.md): How daily and monthly limits, per-call caps and limit errors work.
- [For agents](https://groundtruthdata.co.za/docs/agents.md): Machine-readable ways to read these docs and what the server expects of an agent.

## Tools

- [Tool reference](https://groundtruthdata.co.za/docs/tools.md): The bounded tools the GroundTruthData MCP server exposes.
- [describe_catalog](https://groundtruthdata.co.za/docs/tools/describe_catalog.md): List the metrics, geographies, time coverage and per-call limits this server offers.
- [resolve_location](https://groundtruthdata.co.za/docs/tools/resolve_location.md): Turn a place name or a lat/lon point into canonical area_ids (max 5 candidates).
- [query_metrics](https://groundtruthdata.co.za/docs/tools/query_metrics.md): Get aggregated, cited metric values for up to 25 areas (max 200 rows).
- [compare_areas](https://groundtruthdata.co.za/docs/tools/compare_areas.md): Compare 2-5 areas on up to 5 metrics: value, rank among them (1 = highest) and the national percentile among all areas of the same type.
- [get_provenance](https://groundtruthdata.co.za/docs/tools/get_provenance.md): Where a metric comes from: publisher, licence, retrieval date, dataset version, method and lineage.

## Reference

- [Citations and provenance](https://groundtruthdata.co.za/docs/citations.md): Every number carries its source, licence, retrieval date and dataset version.

## Optional

- [Changelog](https://groundtruthdata.co.za/changelog): Release notes
- [Pricing](https://groundtruthdata.co.za/pricing): Plans and limits
- [Coverage](https://groundtruthdata.co.za/coverage): Data sources and their licences