Consensus Tools#

Configuration File: consensus_tools.json Tool Type: Local Tools Count: 1

This page contains all tools defined in the consensus_tools.json configuration file.

Available Tools#

Consensus_search_papers (Type: ConsensusTool)#

Search 220M+ peer-reviewed papers via the Consensus API (https://consensus.app), returning ranked…

Consensus_search_papers tool specification

Tool Information:

  • Name: Consensus_search_papers

  • Type: ConsensusTool

  • Description: Search 220M+ peer-reviewed papers via the Consensus API (https://consensus.app), returning ranked papers with an AI-generated one-line takeaway per paper plus study-design metadata (study type, sample size, journal quality) for evidence triage rather than raw retrieval. Complements PubMed/Europe PMC/OpenAlex: broader than biomedical-only sources, and surfaces a synthesized ‘what does this paper conclude’ takeaway instead of just an abstract. Requires CONSENSUS_API_KEY (paid Consensus account: https://consensus.app/home/api).

Parameters:

  • query (string) (required) Natural-language research question, e.g. ‘Does creatine improve cognition?’

  • year_min (integer) (optional) Minimum publication year.

  • year_max (integer) (optional) Maximum publication year.

  • month_min (integer) (optional) Minimum publication month (1-12), used with year_min.

  • month_max (integer) (optional) Maximum publication month (1-12), used with year_max.

  • study_types (string) (optional) Comma-separated study designs to filter by, e.g. ‘rct,meta-analysis,systematic review,cohort study’.

  • human (boolean) (optional) Restrict to human studies only.

  • controlled (boolean) (optional) Restrict to controlled studies only.

  • sample_size_min (integer) (optional) Minimum study sample size.

  • exclude_preprints (boolean) (optional) Exclude preprints from results.

  • sjr_min (integer) (optional) Minimum SJR journal-quality quartile (1 = top quartile).

  • sjr_max (integer) (optional) Maximum SJR journal-quality quartile (1 = top quartile).

  • citation_min (integer) (optional) Minimum citation count.

  • medical_mode (boolean) (optional) Restrict to top medical journals and clinical guidelines (~8M docs).

  • domain (string) (optional) Subject area filter, e.g. ‘med’, ‘bio’, ‘cs’, ‘psych’, ‘econ’.

  • country (string) (optional) Filter by study country.

  • journal_name (string) (optional) Filter by exact journal name.

  • publisher_name (string) (optional) Filter by publisher name.

  • open_access (boolean) (optional) Restrict to open-access papers only.

  • include_semantic_score (boolean) (optional) Include a relevance (semantic similarity) score per result.

  • include_full_text_chunks (boolean) (optional) Include query-relevant full-text excerpts per result, where available.

  • page (integer) (optional) Zero-indexed page number for pagination; see the returned next_page/is_end fields.

Example Usage:

query = {
    "name": "Consensus_search_papers",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)