The Gastrologer — GI clinical tools for agents

List every clinician teaching module and patient chapter: title, canonical URL, evidence-review date.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Search clinician teaching modules AND patient chapters by free-text query (title, description, and body text); returns matching modules with snippets.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "maximum": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Read ONE module's full teaching text (markdown) with required citation. Not for bulk corpus assembly.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Get the claim ledger (claim → evidence rows) for a module, when published.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Dated evidence-review log for all modules.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

The current GASTROLOGER_CLINICAL_STATE: version, corpus/section/module Merkle roots, counts and hash scheme — pin an answer to an exact knowledge state.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Verify one clinical claim against the published corpus root via its Merkle inclusion proof (optionally against a bundle_hash you hold). Returns the claim content only when it is physician-activated or clinician-adjudicated.

{
  "type": "object",
  "properties": {
    "claim_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{3,40}$"
    },
    "bundle_hash": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$"
    }
  },
  "required": [
    "claim_id"
  ],
  "additionalProperties": false
}

Fact-check pasted text (a social post, caption, or sentence): canonical wording or its full explicit negation can receive a scoped governed verdict; other matches return unresolved reviewed candidates with evidence. No video retrieval or individual medical advice.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

Resolve one supplied proposition against governed claims. Only preserved canonical wording or its full explicit negation is certified; lexical candidates and changed qualifiers remain unresolved. Does not search external evidence.

{
  "type": "object",
  "properties": {
    "claim": {
      "type": "string"
    }
  },
  "required": [
    "claim"
  ],
  "additionalProperties": false
}

Search canonical GI fact-check verifications by free text; returns matching governed claims with canonical /verify/ URLs.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "maximum": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Get one canonical verification record (statement, verdict, review date, evidence module, machine URLs) by its slug or claim id.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{3,110}$"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Resolve up to 10 claims (by claim_ids or free-text query) into an evidence bundle: statements, verdicts, review dates, evidence pointers, canonical URLs, clinical-state pin. Optional locale (BCP-47) reports human-localized module availability; canonical identifiers are language-independent. Bulk export beyond 10 claims is the paid tier (x402) at /api/premium/evidence-pack.

{
  "type": "object",
  "properties": {
    "claim_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9-]{3,40}$"
      },
      "maxItems": 10
    },
    "query": {
      "type": "string",
      "maxLength": 500
    },
    "locale": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2,3}(-[A-Za-z0-9]{2,8})*$"
    }
  },
  "additionalProperties": false
}

Legacy HRM operation quarantined after rule discrepancies were reproduced against reviewed teaching. Returns needs_review without classification. Do not invoke to obtain a diagnosis; this compatibility name is omitted from new plugin products.

{
  "type": "object",
  "properties": {
    "metrics": {
      "type": "object",
      "properties": {
        "irp_mmhg": {
          "type": "number"
        },
        "dci_mmhg_cm_s": {
          "type": "number"
        },
        "dl_s": {
          "type": "number"
        },
        "pct_failed": {
          "type": "number"
        },
        "pct_panesophageal": {
          "type": "number"
        },
        "pct_premature": {
          "type": "number"
        },
        "pct_hypercontractile": {
          "type": "number"
        },
        "pct_weak": {
          "type": "number"
        },
        "pct_fragmented": {
          "type": "number"
        }
      }
    },
    "manufacturer": {
      "type": "string",
      "enum": [
        "Medtronic",
        "Laborie",
        "Diversatek",
        "Unknown"
      ]
    },
    "position": {
      "type": "string",
      "enum": [
        "supine",
        "upright"
      ]
    },
    "provocative": {
      "type": "object"
    },
    "secondary_testing": {
      "type": "object"
    }
  },
  "required": [
    "metrics"
  ],
  "additionalProperties": false
}

Score a governed clinical instrument from structured responses: IBS-SSS (ibs-sss, 5 slider items 0-100 + days×10, total 0-500) and GERD-Q (gerd-q, 6 choice items, total 0-18, ≥8 consistent with GERD). Returns total, percent of max, band label + interpretation, and the instrument citation. Every item is required; invalid/missing responses are rejected without defaulting or clamping. Educational scoring — not a diagnosis. Also POST /api/tools/score-instrument.

{
  "type": "object",
  "properties": {
    "instrument": {
      "type": "string",
      "enum": [
        "ibs-sss",
        "gerd-q"
      ]
    },
    "responses": {
      "type": "object",
      "description": "item_id → numeric value (see instrument spec at /tools/instruments.json)"
    }
  },
  "required": [
    "instrument",
    "responses"
  ],
  "additionalProperties": false
}

Query the evidence-backed clinical relationship graph (subject–predicate–object triples over diseases, medications, tests, findings, guidelines). Every relation cites governed claim IDs and/or evidence registry IDs. Filter by node text (subject/object), predicate (treated_by, evaluated_by, contraindicated_by, increases_risk_of, reduces_risk_of, causes, associated_with, suggests, argues_against, complicated_by, recommended_by, supported_by, conflicts_with, supersedes, requires_context_of), kind, or a claim_id. Also GET /api/tools/relations.

{
  "type": "object",
  "properties": {
    "node": {
      "type": "string",
      "description": "substring match against subject_id/object_id"
    },
    "predicate": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "description": "filter subject_kind or object_kind (disease, medication, test, finding, guideline, risk_factor, mechanism, intervention)"
    },
    "claim_id": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "maximum": 25
    }
  },
  "additionalProperties": false
}