evidenceos-frontend.vercel.app

{
  "name": "search_literature",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the biomedical literature (PubMed) for papers matching a clinical question. Returns a page of structured papers (PMID, title, authors, journal, publication date, DOI). Use first when finding or screening primary studies for a review. Read-only.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/search_literature",
    "title": "Search literature",
    "description": "Search biological and medical literature (PubMed).",
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500,
        "description": "Free-text or PubMed-style clinical search query, e.g. \"metformin AND type 2 diabetes\"."
      },
      "page": {
        "type": "integer",
        "minimum": 1,
        "default": 1,
        "description": "Page of results to return (1-based)."
      },
      "page_size": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "default": 25,
        "description": "Number of results per page (1–100)."
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_paper",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch full metadata for a single paper by PubMed ID (number or digit string) or EvidenceOS paper UUID: title, abstract, authors, journal, publication date, DOI and URL. Use to inspect a paper before adding it to a review. Read-only.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/get_paper",
    "title": "Get paper",
    "description": "Fetch full metadata for a single paper.",
    "type": "object",
    "properties": {
      "reference": {
        "oneOf": [
          {
            "type": "integer",
            "minimum": 1,
            "description": "PubMed ID (PMID) to fetch."
          },
          {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "PubMed ID given as a digit string."
          },
          {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
            "description": "Internal EvidenceOS paper UUID."
          }
        ],
        "description": "The paper to fetch: a PubMed ID or an EvidenceOS paper UUID."
      }
    },
    "required": [
      "reference"
    ],
    "additionalProperties": false
  }
}

{
  "name": "create_review",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a new evidence review for collecting and synthesizing papers. Requires a title; an optional research question focuses the review. Returns the new review's UUID, which other tools (add_paper_to_review, get_evidence_matrix) require. Mutates: creates a review.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/create_review",
    "title": "Create review",
    "description": "Start a new evidence review.",
    "type": "object",
    "properties": {
      "title": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "description": "Short, descriptive title for the review."
      },
      "research_question": {
        "type": [
          "string",
          "null"
        ],
        "maxLength": 2000,
        "description": "Optional focused research question the review will answer."
      }
    },
    "required": [
      "title"
    ],
    "additionalProperties": false
  }
}

{
  "name": "add_paper_to_review",
  "kind": "act",
  "impl": "imperative",
  "description": "Attach a paper (by PubMed ID) to an existing review (by UUID), optionally setting its screening status and notes. Paper metadata is fetched from PubMed if not already cached. Returns the new screening link including the internal paper UUID. Mutates: adds to the review.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/add_paper_to_review",
    "title": "Add paper to review",
    "description": "Attach a paper to a review.",
    "type": "object",
    "properties": {
      "review_id": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "description": "EvidenceOS review UUID, as returned by create_review or get_evidence_matrix."
      },
      "pmid": {
        "type": "integer",
        "minimum": 1,
        "description": "PubMed ID of the paper to attach (see search_literature / get_paper)."
      },
      "status": {
        "type": "string",
        "enum": [
          "pending",
          "screened",
          "included",
          "excluded"
        ],
        "default": "pending",
        "description": "Initial screening status."
      },
      "notes": {
        "type": [
          "string",
          "null"
        ],
        "maxLength": 5000,
        "description": "Optional free-text note about the paper."
      }
    },
    "required": [
      "review_id",
      "pmid"
    ],
    "additionalProperties": false
  }
}

{
  "name": "remove_paper_from_review",
  "kind": "act",
  "impl": "imperative",
  "description": "Detach a paper (by EvidenceOS paper UUID) from a review (by UUID). The paper stays cached in EvidenceOS; only the screening link is removed. Mutates: removes from the review.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/remove_paper_from_review",
    "title": "Remove paper from review",
    "description": "Detach a paper from a review.",
    "type": "object",
    "properties": {
      "review_id": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "description": "EvidenceOS review UUID, as returned by create_review."
      },
      "paper_id": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "description": "EvidenceOS paper UUID, as returned by add_paper_to_review or get_evidence_matrix."
      }
    },
    "required": [
      "review_id",
      "paper_id"
    ],
    "additionalProperties": false
  }
}

{
  "name": "extract_evidence",
  "kind": "act",
  "impl": "imperative",
  "description": "Run structured evidence extraction for a paper (by PubMed ID or paper UUID), producing PICO plus study design, sample size, key finding, limitations and confidence. Results are LLM-generated and labelled as such — verify against the source before relying. Mutates: writes an extraction. Needs the LLM provider configured.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/extract_evidence",
    "title": "Extract evidence",
    "description": "Generate structured evidence from a paper.",
    "type": "object",
    "properties": {
      "reference": {
        "oneOf": [
          {
            "type": "integer",
            "minimum": 1,
            "description": "PubMed ID (PMID) to extract evidence from."
          },
          {
            "type": "string",
            "pattern": "^[1-9][0-9]*$",
            "description": "PubMed ID given as a digit string."
          },
          {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
            "description": "Internal EvidenceOS paper UUID."
          }
        ],
        "description": "The paper to run LLM-assisted evidence extraction on: a PubMed ID or an EvidenceOS paper UUID."
      }
    },
    "required": [
      "reference"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_evidence_matrix",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the evidence matrix for a review (by UUID): every attached paper with its current screening status and its latest extracted evidence. Use to synthesize or check the state of a review. Read-only.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/get_evidence_matrix",
    "title": "Get evidence matrix",
    "description": "Return the structured evidence matrix for a review.",
    "type": "object",
    "properties": {
      "review_id": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "description": "EvidenceOS review UUID, as returned by create_review."
      }
    },
    "required": [
      "review_id"
    ],
    "additionalProperties": false
  }
}

{
  "name": "compare_papers",
  "kind": "act",
  "impl": "imperative",
  "description": "Compare structured evidence across 2–6 papers (by PubMed ID). Builds a deterministic per-dimension side-by-side — population, intervention, comparison, outcome, study design, sample size, key finding, limitations, confidence — flagging disagreements and gaps. Papers without extraction are listed as not extracted. Read-only.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "evidenceos/tools/compare_papers",
    "title": "Compare papers",
    "description": "Compare structured evidence across papers side-by-side.",
    "type": "object",
    "properties": {
      "references": {
        "type": "array",
        "items": {
          "type": "integer",
          "minimum": 1,
          "description": "PubMed ID of a paper to compare."
        },
        "minItems": 2,
        "maxItems": 6,
        "uniqueItems": true,
        "description": "2–6 PubMed IDs to compare side-by-side."
      }
    },
    "required": [
      "references"
    ],
    "additionalProperties": false
  }
}