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. Agents can settle calls in USDC on Arbitrum One or Base, or USD₮0 on X Layer.

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",
  "service_tier": "photo_visit",
  "target_location": {
    "label": "Store 42",
    "latitude": 12.9716,
    "longitude": 77.5946
  }
}

Live payment rails

The unpaid endpoint returns only facilitator-supported options. Every public USDC rail fails closed if settlement is not confirmed.

eip155:42161Arbitrum One · USDCCanonical USDC · exact authorization
eip155:8453Base · USDCCanonical USDC · exact authorization
eip155:196X Layer · USD₮0OKX marketplace rail

Predictable task pricing

The server maps each named tier to an exact x402 amount. Agents cannot advertise one reward and pay another.

integration_test0.01 USDC
evaluation_test0.10 USDC
quick_check2 USDT
photo_visit5 USDT
urgent_visit15 USDT
complex_visit50 USDT

integration_test is the capped $0.01 hackathon and machine-compatibility path. It validates payment and orchestration only. quick_check is the smallest $2 field mission.

Public beta: production traffic requires an agreed pilot, coverage confirmation, and payment configuration. Review the trust model and acceptable-use policy before dispatch.