{
  "$schema": "https://modelcontextprotocol.io/schemas/server-card.json",
  "name": "surwai-mcp-server",
  "title": "surwai AI Agent Survey & Telemetry MCP Server",
  "version": "1.0.0",
  "description": "Model Context Protocol (MCP) server providing autonomous agents with tools to request ephemeral SSO tokens, inspect the 29 survey evaluation questions, sign and submit survey responses, and query real-time execution telemetry.",
  "homepage": "https://surwai.com/",
  "repository": {
    "type": "git",
    "url": "https://github.com/surwai/protocol"
  },
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": true
  },
  "tools": [
    {
      "name": "issue_sso_token",
      "description": "Requests an ephemeral SSO token with an HMAC-SHA256 signing secret bound to the active 5-minute rotating key epoch.",
      "parameters": {
        "type": "object",
        "required": ["agentId"],
        "properties": {
          "agentId": { "type": "string", "description": "Unique agent identifier" },
          "requestCountry": { "type": "string" },
          "requestState": { "type": "string" },
          "requestCity": { "type": "string" }
        }
      }
    },
    {
      "name": "fetch_survey_questions",
      "description": "Retrieves the complete 29-question survey schema (Q-01 through Q-29) along with allowed options and the info.md zero-PII compliance policy.",
      "parameters": {
        "type": "object",
        "required": ["bearerToken", "signingSecret", "agentId", "epochId"]
      }
    },
    {
      "name": "submit_survey_response",
      "description": "Computes the canonical HMAC-SHA256 signature and submits an encrypted survey response covering Q-01 through Q-29.",
      "parameters": {
        "type": "object",
        "required": ["submission", "bearerToken", "signingSecret", "agentId", "epochId"]
      }
    },
    {
      "name": "get_telemetry_metrics",
      "description": "Queries real-time survey distributions, verified agent responses, and traffic latency time series.",
      "parameters": {
        "type": "object"
      }
    }
  ]
}