{
  "protocolVersion": "1.0",
  "name": "Vagus Lab Research",
  "version": "1.0.0",
  "description": "Independent research publication on vagus nerve stimulation. Answers grounded questions from a curated corpus of published VNS studies, and publishes a scored comparison of consumer VNS devices. Read-only, no authentication, no generation model in the loop: the caller's own model writes the answer from the cited passages this agent returns.",
  "provider": {
    "organization": "Vagus Lab",
    "url": "https://vaguslab.net"
  },
  "documentationUrl": "https://vaguslab.net/api-docs/",
  "supportedInterfaces": [
    {
      "url": "https://vaguslab.net/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0",
      "transport": "json-rpc"
    }
  ],
  "url": "https://vaguslab.net/a2a",
  "preferredTransport": "json-rpc",
  "capabilities": {
    "extensions": [],
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "skills": [
    {
      "id": "search_research",
      "name": "Search the VNS research corpus",
      "description": "Search a curated corpus of published vagus nerve stimulation research (3,093 studies indexed as 20,535 passages, including 596 RCTs, systematic reviews and meta-analyses). Returns cited snippets with study tier, evidence grade, publication year, and source URL. Evidence for one device never transfers to another: check the deviceRole field before attributing a finding to a product.",
      "tags": [
        "research",
        "vagus-nerve",
        "vns",
        "evidence",
        "citations",
        "health"
      ],
      "examples": [
        "What does the evidence say about taVNS and heart rate variability?",
        "Is there RCT evidence for vagus nerve stimulation improving sleep?",
        "Which VNS studies used the Nurosym device?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_devices",
      "name": "Get the scored device comparison",
      "description": "Six consumer VNS devices with Vagus Lab's editorial score out of 10, price, use-case badge, pros and cons, and merchant return terms. Scores are editorial, authored from a ten-criterion weighted methodology, and are not consumer ratings. Vagus Lab earns affiliate commission on some purchases; the payload carries that disclosure.",
      "tags": [
        "devices",
        "comparison",
        "scores",
        "pricing",
        "commerce"
      ],
      "examples": [
        "Which vagus nerve stimulation device scores highest?",
        "Compare Pulsetto and Nuropod on price and score."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "list_articles",
      "name": "List published articles",
      "description": "Index of every published Vagus Lab article with URL, category, and evidence grade. Any article URL returns clean markdown when fetched with the header 'Accept: text/markdown'.",
      "tags": [
        "articles",
        "index",
        "content",
        "markdown"
      ],
      "examples": [
        "What has Vagus Lab published about sleep?",
        "List all device articles."
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}
