START HERE · 5–10 MINUTES

Ship your first data contract

Use the dashboard or MCP tools to create a workspace, define the JSON shape your workflow expects, and validate payloads before an AI agent or downstream service consumes them.

What you need

A browser and a JSON example. The capped public playground needs no payment; persistent contracts and monitoring require Starter at $9/month.

Open the Zorqelio dashboard →

Create an account

Create a Zorqelio account with your email, a password of at least 12 characters, and a workspace name. Your dashboard session expires after 14 days; sign in again to create a fresh session. Account registration creates one workspace. Existing workspace API tokens continue to work for direct API and MCP access.

Keep the one-time workspace API token in a password manager or server-side secret manager. Do not put it in public frontend code.

1. Create a workspace

Open the dashboard and choose Create workspace. Give it a name. Zorqelio displays a workspace API token once. Copy it into a password manager or your server-side secret store. Do not put it in frontend JavaScript, public repositories, or client-side applications.

2. Create a contract

Create a contract from the dashboard, or call contract_create through the MCP server with your workspace token. The schema below is a small order-response contract.

{
  "type": "object",
  "required": ["id", "status", "total"],
  "properties": {
    "id": { "type": "string" },
    "status": { "type": "string", "enum": ["open", "paid", "cancelled"] },
    "total": { "type": "number", "minimum": 0 }
  },
  "additionalProperties": false
}

For MCP, pass the schema as a JSON-encoded string. The returned contract access token is shown once; save it securely.

3. Validate a payload

With MCP, call contract_validate using contractId, accessToken, and the JSON payload as a string in json. Or use the REST workspace validation endpoint:

curl -X POST https://zorqelio.xyz/api/v1/workspace/validate \
  -H "Authorization: Bearer $ZORQELIO_WORKSPACE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "YOUR_CONTRACT_UUID",
    "payload": {"id":"ord_123","status":"paid","total":49.5}
  }'

The response includes valid, an ALLOW or BLOCK decision, issue evidence, contract version, and timestamp. A failed validation is a useful result: inspect the issue paths and fix or intentionally update the upstream contract.

4. Add freshness monitoring

Create a monitor from the dashboard or the monitor_create MCP tool. It returns a monitor ID, a POST endpoint and a one-time bearer token. Configure your own job or integration to submit each fresh JSON response at the interval you selected.

curl -X POST "https://zorqelio.xyz/api/v1/monitors/YOUR_MONITOR_ID/check" \
  -H "Authorization: Bearer $ZORQELIO_MONITOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"ord_123","status":"paid","total":49.5}'

5. Review the result

Return to the dashboard to inspect validation history and monitor health. You can also call monitor_status and monitor_history with your monitor ID and token.

Next steps