Repository avatar
Search & Data Extraction
v1.1.0
active

research

net.vaguslab/research

Cited VNS research passages from a curated corpus, plus a scored device comparison.

Documentation

Vagus Lab Research: MCP and A2A server

Source of the agent endpoints that run at https://vaguslab.net/mcp (Model Context Protocol) and https://vaguslab.net/a2a (A2A). Listed in the official MCP Registry as net.vaguslab/research.

Vagus Lab is an independent research publication on vagus nerve stimulation (VNS). This server lets an AI agent ground its answer in published VNS research instead of guessing.

This repository is a read-only mirror, published so anyone can check what the server does before connecting to it. The site itself lives in a private repository; this code is copied from it on every change to the server.

What it does

Three tools, all read-only:

ToolReturns
search_researchCited passages from a curated corpus of VNS studies, with study tier, evidence grade, year, source URL, and deviceRole (whether the study used a named device).
get_devicesVagus Lab's scored comparison of consumer VNS devices. Scores are editorial, not consumer ratings. Vagus Lab earns affiliate commission on some purchases, and the payload says so.
list_articlesIndex of published articles. Any article URL returns clean markdown when fetched with Accept: text/markdown.

What it does not do

  • No generation model. The server returns passages; your own model writes the answer. No call to Claude or any other LLM happens here.
  • No writes, no accounts, no auth.
  • What we record. For each tool call: the tool name, your client's user agent (first 80 characters), the search_research query (first 200 characters), and whether it came over MCP or A2A. No IP address, no other arguments. It tells us whether anyone actually uses this server and what they ask. See src/usage.ts. Cloudflare also keeps its standard request logs.
  • Capped exposure. Snippets are cut at 480 characters, at most 10 per call, and each IP gets 30 requests per minute.

Connect

{
  "mcpServers": {
    "vaguslab": { "type": "http", "url": "https://vaguslab.net/mcp" }
  }
}

Server card: https://vaguslab.net/.well-known/mcp/server-card.json A2A agent card: https://vaguslab.net/.well-known/agent-card.json Human docs: https://vaguslab.net/api-docs/

Run it yourself

It is a Cloudflare Worker. The corpus lives in a private Postgres database, so a local copy needs your own DATABASE_URL with the same schema; get_devices and list_articles read the public JSON at vaguslab.net/api/public/ and work as is.

npm install
npm run typecheck
npx wrangler dev

Contact

contact@vaguslab.net. Issues on this repository are read too.

No installation packages available.

Remote