# GroundTruth

> One 0 to 100 travel risk score per country, fused from the CIA World Factbook, ACLED, GDELT and five more conflict intelligence sources. Know the ground before you book.

GroundTruth is travel intelligence for a world with 23 active armed conflicts. It fuses eight authoritative feeds (CIA World Factbook country profiles, ACLED armed conflict events, GDELT news monitoring, US State Department advisories, UK FCDO travel advice, ReliefWeb/OCHA humanitarian reporting, the Global Terrorism Database and FAA/EUROCONTROL NOTAMs) into a single Travel Risk Score per country, plus country dossiers, a leg-by-leg route analyzer and a daily intel brief. The score is a weighted composite of six factors: ACLED conflict events at 35%, official travel advisories at 20%, GDELT news sentiment at 15%, terrorism risk from the GTD at 15%, humanitarian crisis alerts at 10% and airspace status at 5%, with events decaying over a 30-day rolling window. Scores resolve at sub-national precision, so Beirut reads differently from southern Lebanon. The point is to help people travel informed, not afraid.

It serves business travelers, solo and adventure travelers, corporate travel managers responsible for duty-of-care, journalists and NGO workers deploying near conflict zones and travel agencies advising clients.

Planned pricing at launch has three tiers. Free ($0) includes 3 country dossier views per month and global conflict map access. Pro ($19 per month) adds unlimited dossiers, route analysis and the daily intel brief. Enterprise (custom quote) adds API access, team dashboards and compliance reporting. The product is pre-launch and an early access list is open; early members lock the Pro rate for a year.

For AI agents, GroundTruth exposes a Model Context Protocol (MCP) server over streamable-HTTP transport with no authentication required (the tools are public). The server is mounted at /mcp, so the JSON-RPC endpoint lives one level deeper at https://groundtruth.io/mcp/mcp; point streamable-HTTP clients at that full path. Two tools are available via the standard tools/list call. `get_product_info` returns the product name, tagline, features, data sources, target audience, pricing tiers, risk score methodology and launch status. `submit_interest` joins the early access list on a user's behalf (email required; name, company, persona and message optional); valid persona values are business_traveler, solo_traveler, travel_manager, journalist, ngo_worker, travel_agency and other. Interest can also be submitted over REST via POST /api/interest, which requires a bot-protection token flow: GET /api/init to receive the _bs cookie, then send _ts (current unix seconds as a string) and _token (first 16 hex characters of HMAC-SHA256 keyed with the cookie value over the _ts string), and leave the honeypot `website` field empty. The same flow is documented in /openapi.json on the /api/init endpoint and the InterestCreate schema.

## Docs

- [Homepage](https://groundtruth.io/): the GroundTruth landing page with capabilities, the source manifest, pricing and the early access form
- [Live demo](https://groundtruth.io/demo): interactive field console with the conflict radar map, a full Lebanon dossier, a runnable route analyzer and a sample daily intel brief

## For AI agents

- [MCP endpoint](https://groundtruth.io/mcp/mcp): streamable-HTTP JSON-RPC endpoint for get_product_info and submit_interest (the server is mounted at /mcp)
- [MCP discovery](https://groundtruth.io/.well-known/mcp.json): machine-readable advertisement of the MCP server and its tools
- [OpenAPI spec](https://groundtruth.io/openapi.json): REST description of the site's HTTP endpoints for non-MCP agents
- [security.txt](https://groundtruth.io/.well-known/security.txt): security contact for the site

## Optional

- [Contact](mailto:hello@groundtruth.io): reach the GroundTruth team directly
- [Sitemap](https://groundtruth.io/sitemap.xml): crawlable URL list for the site