← home · ← tools · View as Markdown (.md) · JSON

safety-margin

station__vigilance__safety-margin external (needs EXECUTION_BACKEND_URL) vigilance pv-core Constructa Configa

Calculate safety margin distance d(s) — a weighted composite of four disproportionality metrics (PRR, ROR lower CI, IC025, EB05) and case count. d > 1.0 = clear signal; d > 0.5 = probable signal; d > 0.0 = borderline; d <= 0.0 = below threshold. Use after running PRR/ROR/IC/EBGM to synthesize a single decision metric.

Taxonomy

Linnaean classification joined from the algovigilance taxonomy index via the parent config's rank.

Rank	Value
domain	`Substrata`
kingdom	`Constructa`
phylum	`Configa`
class	`station-config`
order	`vigilance`
family	`mcp-tool-config`

Characteristics:

substrate: config
domain: pv
lifecycle: continuous
authority: read
compounding: producer
io: agent-request → tool-response

Input schema

prr numberrequired — Proportional Reporting Ratio value (from compute-prr)
ror_lower numberrequired — ROR lower 95% confidence interval (from compute-ror)
ic025 numberrequired — IC lower credibility interval (IC025, from compute-ic)
eb05 numberrequired — EBGM 5th percentile (EB05, from compute-ebgm)
n integerrequired — Number of case reports for this drug-event pair

Example call

POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "station__vigilance__safety-margin",
    "arguments": {
      "prr": 0,
      "ror_lower": 0,
      "ic025": 0,
      "eb05": 0,
      "n": 0
    }
  }
}

How to invoke from a client

From any MCP-aware client, add https://algovigilance.com/api/mcp as an MCP server, then call this tool by name. From a raw HTTP client, send the JSON-RPC body above to /api/mcp.

Agent-friendly formats

Working inside an AI assistant? Use the Copy for AI button at the top of this page (or view the raw Markdown) to paste a clean, token-budgeted version of this tool's contract into your conversation.

All tools (3062 live)
/api/mcp — endpoint
/AGENTS.md — agent guide
/tools/vigilance__safety-margin/raw.md — this page's Markdown twin