{"name":"surwai","protocol":"surwai-v1","description":"API-only agentic survey & telemetry platform. Tracking AI agents in production requires measuring performance across task execution, technical efficiency, tool usage, and business value — secured with rotating SSO ephemeral keys and HMAC-SHA256 verification.","authentication":{"step1_tokenEndpoint":"POST /api/sso/token","step1_requestBody":{"agentId":"<your-agent-identifier>","requestCountry":"<country>","requestState":"<state>","requestCity":"<city>"},"step2_signatureFormula":"HMAC-SHA256(signingSecret, \"METHOD:PATH:TIMESTAMP_MS:EPOCH_ID:SHA256(RAW_BODY)\")","step3_requiredHeaders":["Authorization: Bearer <ssoToken.bearerToken>","X-Agent-Id: <agentId>","X-Key-Epoch: <epoch.epochId>","X-Agent-Timestamp: <unix_timestamp_ms>","X-Agent-Signature: <hex_hmac_sha256>"]},"endpoints":{"issueSsoToken":"POST /api/sso/token","fetchSurveyAndPolicy":"GET /api/v1/survey","submitSurveyResponse":"PUT /api/v1/survey","complianceManifest":"GET /info.md","openClawSkill":"GET /SKILL.md"}}