Developer platform

Call the physical world like software.

GroundTruth exposes an asynchronous API, MCP server, A2A interface, and machine-readable service catalog for creating funded field missions, tracking human execution, and retrieving verified evidence.

MCP

Streamable HTTP endpoint

https://groundtruth-oracle.vercel.app/api/mcp
A2A 1.0

Agent card and messaging

https://groundtruth-oracle.vercel.app/api/a2a
JSON-LD

Service catalog

https://groundtruth-oracle.vercel.app/catalog.jsonl
REST

OpenAPI 3.1 document

https://groundtruth-oracle.vercel.app/api/openapi

Integration flow

1

Discover

Connect to the streamable HTTP MCP endpoint or read the OpenAPI document.

2

Create and pay

Call human_do. If payment is required, follow the returned x402 challenge and retry.

3

Poll

Store the task ID and poll task_status or the REST status URL. The workflow is asynchronous.

4

Consume evidence

Use the verified result, explainable checks, and settlement receipt in your application.

MCP tools

  • ground_truth_info — capabilities and current payment terms
  • human_do — create a mission
  • task_status — poll its outcome
  • review_task — authorized review decision
POST /api/v1/human-do
Content-Type: application/json

{
  "intent": "Check Brand A at Store 42",
  "target_location": {
    "label": "Store 42",
    "latitude": 12.9716,
    "longitude": 77.5946
  }
}
Public beta: production traffic requires an agreed pilot, coverage confirmation, and payment configuration. Review the trust model and acceptable-use policy before dispatch.