Tools API
Programmatic access to Caelrith’s integrated knowledge graph – clinical trial search, biological associations, drug‑target networks, entity resolution, grant funding analytics, regulatory intelligence, and financial metrics. Each tool has its own daily rate limit defined in your workspace tier.
92 tools across 25 categories · catalog vmcp-2026-10-28
Prefer calling these from an AI client? The same tools are available over MCP — MCP Server reference.
Clinical Trial Registry4 tools
/api/v1/clinical-trialsClinical Trial Registry Search
Paginated search over registry trial DOCUMENTS with full-text phrase search and field filters (all AND-combined). Returns rich per-trial records (tit…
/api/v1/clinical-trials/:trialIdTrial Full Record
Retrieve one complete registry trial document by its registry id, including ALL update_logs, eligibility criteria, officials, contacts, facilities, r…
/api/v1/clinical-trials/sampleTrial Registry Sample
Return up to 5 recently updated trial documents from the registry. Cheap way to inspect the real document shape or to fetch exact OpenAlex topic-name…
/api/v1/clinical-trials/topicsClinical Trials by Topic
Search trials by OpenAlex topic name (exact PHRASE match over openalex_topics[].topic_name; relevance-sorted by default). Accepts every optional filt…
Clinical Trials4 tools
/api/v1/tools/clinical/portfolio-comparisonPortfolio Comparison
Compare clinical trial portfolios of multiple sponsors for a specific disease. Returns market size, intersection counts, per-sponsor breakdowns, and…
/api/v1/tools/clinical/search-compositeClinical Composite Search
Search clinical trials by disease, drug, target, and sponsor with combination filters. All parameters optional; at least one biological filter recomm…
/api/v1/tools/clinical/trial-detailsTrial Details
Retrieve a single clinical trial's graph-enriched details by NCT ID (exact nct_id match, stored UPPERCASE; NCT ids only - not EU CT numbers). Returns…
/api/v1/tools/clinical/trial-posTrial Probability of Success
Machine-learning Probability of Success (POS) for ONE clinical trial, scored live from the trial's design features (phase, blinding, statistical-anal…
Researchers2 tools
/api/v1/researchers/:authorIdResearcher Profile
Profile document for a researcher (principal investigator) resolved to an OpenAlex author. Use trial documents or pi_author_id results from the regis…
/api/v1/researchers/:authorId/worksResearcher Works
Paginated publication list (OpenAlex works) for a researcher already resolved to an OpenAlex author: title, full DOI url, type, publication_date, pub…
Biology & Targets7 tools
/api/v1/tools/biology/associationsBiological Associations
Discover target-disease or disease-target associations with confidence scores and evidence counts. Resolves the input entity against targets first, t…
/api/v1/tools/biology/drug-to-targetsDrug to Targets
For a given drug (generic or brand), return all known molecular targets, mechanism of action, and related drug forms (salts, biosimilars). Targets ar…
/api/v1/tools/biology/drugsDrugs
Returns a paginated list of drugs with metadata (page, limit, totalItems, totalPages). Call it to browse or filter drugs by approval status, developm…
/api/v1/tools/biology/drugs/:key/similar-by-targetSimilar By Target
Returns drugs that share at least one protein target with the given drug, ranked by overlap, along with the shared targets and the resolved root drug…
/api/v1/tools/biology/prioritize-targetsPrioritize Targets
Rank molecular targets for a disease with approved drugs, trial activity, sponsors, and a novelty score. Useful for identifying promising targets for…
/api/v1/tools/biology/target-landscapeTarget Landscape
Explore the competitive landscape for a molecular target: all modulating drugs with approval status, safety warnings, max clinical phase (numeric, co…
/api/v1/tools/biology/target-to-drugsTarget to Drugs
Look up all drugs that modulate a specific biological target (fixed 50-drug cap per call). Returns drug name, phase, approval status, mechanism of ac…
Entity Resolution1 tool
Grants & Funding5 tools
/api/v1/grantsGrant Registry Search
Paginated full search over NIH RePORTER and EU CORDIS grant RECORDS: full-text search over title/abstract plus indexed filters (source, funding range…
/api/v1/grants/:grantIdGrant Full Record
Retrieve ONE grant's full record by its original identifier (NIH application_id or CORDIS id): title, abstract, funding amount, project start/end dat…
/api/v1/grants/sampleGrant Registry Sample
Return a small fixed sample of recent grants (3 NIH + 2 CORDIS) to preview the real grant document shape. Takes no parameters. Available on all works…
/api/v1/grants/sponsor-fundingSponsor Funding
Returns grant money totals for one sponsor organization, broken down by NIH and CORDIS counts and amounts plus a combined total. Accepts a ROR id, LE…
/api/v1/grants/topic-fundingTopic Funding
Returns money totals for a single primary research topic, split by NIH and CORDIS funding, with total grant counts and a combined total. Call it to s…
Regulatory Approvals Registry11 tools
/api/v1/regulatoryRegulatory Approvals Search
Paginated search and listing of harmonised regulatory approval RECORDS (FDA Orange Book, FDA Purple Book, EMA). Supports full-text search plus exact,…
/api/v1/regulatory/:idRegulatory Approvals Record
Retrieve ONE harmonised approval by its PUBLIC approval_id (FDA_ORANGE:020610, FDA_PURPLE:BLA125514, EMA:EU/1/20/1528 - copy it verbatim from the app…
/api/v1/regulatory/:id/historyRegulatory Approval Label History
Label-change HISTORY for ONE approval, keyed by the public approval_id: an ascending list of versions, each with effective_time, previous_effective_t…
/api/v1/regulatory/:id/labelRegulatory Approval Label
Full current openFDA label for ONE FDA approval, keyed by the public approval_id (FDA_ORANGE:... / FDA_PURPLE:BLA...). Returns SPL metadata - setid,…
/api/v1/regulatory/catalystsRegulatory Catalysts
Returns upcoming regulatory catalyst events (patent expiries, exclusivity expiries, approvals) with per-type counts, the applied filters, and a gener…
/api/v1/regulatory/drugs/:key/similar-by-targetSimilar By Target
Returns the targets affected by a given drug plus other drugs that affect any of those same targets, along with counts. Use it to find drugs sharing…
/api/v1/regulatory/landscapeRegulatory Landscape
Returns a regulatory landscape summary for the given filters, including the requested parameters echoed in metadata. Call it to survey the regulatory…
/api/v1/regulatory/organizations/:key/family-treeFamily Tree
Returns an organization's corporate family tree: the resolved root organization plus its ancestors and descendants up to the requested depth. Call it…
/api/v1/regulatory/organizations/:key/subsidiary-approvalsSubsidiary Approvals
Returns a paginated list of regulatory approvals linked to an organization and its subsidiaries, with metadata including total counts and the organiz…
/api/v1/regulatory/profileRegulatory Profile
Returns a regulatory profile for a named drug, including the regulatory information associated with it. Call it when you need regulatory details abou…
/api/v1/regulatory/walkWalk
Traverses the regulatory graph from one or more starting nodes along specified edge types and returns the reached approvals plus a boundary and metad…
Patents4 tools
/api/v1/patentsPatent Search
Paginated, filterable listing of patent publications using direct indexed filters (company/assignee, CPC classification prefix, publication date rang…
/api/v1/patents/:patentIdPatent Full Record
Retrieve ONE patent's full record by its publication identifier (e.g. WO2021098789A1, EP3823456A1): abstract, inventors, classifications with CPC des…
/api/v1/patents/aggregatePatent Aggregates
Fast pre-computed aggregate patent counts (patent_agg_* tables), grouped by year, CPC code and/or company - group_by accepts a comma-separated subset…
/api/v1/patents/yoy-growthPatent YoY Growth
Year-over-year patent growth by CPC code or company (dimension is required). Returns one row per group with oldCount (year_start), newCount (year_end…
Medicare Drug Spending2 tools
/api/v1/medicare-drugsMedicare Drug Spending Search
Paginated, filterable list of Medicare Part D drugs with 2025 spending data: total spending, claims, beneficiaries, average spending per claim/benefi…
/api/v1/medicare-drugs/:keyMedicare Drug Record
Retrieve ONE Medicare Part D drug's full 2025 spending record by its unique _key (derived from the generic name, e.g. 'aripiprazole'). Returns the fu…
Diseases2 tools
/api/v1/diseases/:key/family-treeFamily Tree
Returns the ancestor and descendant branches of a disease in the disease hierarchy, up to the requested depth, along with counts and whether the root…
/api/v1/diseases/autocompleteDisease Autocomplete
Resolve a partial or full disease name to canonical disease entries carrying an ontology CURIE (efo_id, e.g. EFO:0003767). Returns up to 10 name/efo_…
Sponsors1 tool
Financials3 tools
/api/v1/financials/filingsFilings
Returns a paginated, filtered, sorted list of SEC filings with page metadata (totalItems, totalPages, hasMore) and the applied sort/order. Use it to…
/api/v1/financials/lei-to-tickerLEI to Ticker
Returns the LEI's name together with the SEC entities (ticker mappings) associated with that LEI. Call it to resolve a Legal Entity Identifier to its…
/api/v1/financials/metricsFinancial Metrics
Returns financial metrics for a company identified by ticker, including cash, short-term investments, debt, revenue, net income, liquidity, quarterly…
CPC2 tools
/api/v1/cpc/lookupLookup
Returns the single CPC classification entry matching an exact CPC code. Call it to resolve a known CPC code to its classification details. Fails with…
/api/v1/cpc/searchCPC Search
Returns a list of CPC classification codes with their descriptions whose description begins with the supplied query text. Call it to look up CPC code…
Analysis1 tool
Companies4 tools
/api/v1/companiesSearch
Returns a paginated list of company profiles with metadata including total item count, callable with free-text search and structured filters. Use it…
/api/v1/companies/:domainDetails
Returns the profile for a single company identified by its domain, including its linked organizations. Call it when you already know a company's doma…
/api/v1/companies/:domain/similarSimilar
Returns companies similar to the given company, ranked by cosine similarity, along with the source company and metadata about the result set. Use it…
/api/v1/companies/similarSimilar Search
Returns companies ranked by similarity to a free-text query, with metadata on the query, number returned, and how many candidates were skipped. Call…
Drug Pricing2 tools
/api/v1/drug-pricingSearch
Returns paginated Medicare drug pricing records with a data array and meta (page, limit, totalItems, totalPages). Call it to look up drug prices by n…
/api/v1/drug-pricing/:keyDetails
Returns the pricing record for a single drug product identified by its key. Call it when you already have a product key and need that product's prici…
Funding Opportunities2 tools
/api/v1/funding-opportunitiesSearch
Returns a paginated list of funding opportunities, optionally filtered by source, status, sponsor, mention, funding range, and date windows, or narro…
/api/v1/funding-opportunities/:fundingIdDetails
Returns the full record for a single funding opportunity, including its organization chain and complete update history. Call it when you already have…
Funding Rounds5 tools
/api/v1/funding-roundsSearch
Returns a paginated list of funding rounds with company, amount, round type, date, and investor details, plus total count and timing metadata. Call i…
/api/v1/funding-rounds/:idDetails
Returns a single funding round by its id, including its associated organizations and recent update log entries. Call it when you have a funding round…
/api/v1/funding-rounds/companiesCompanies
Returns a paginated list of companies aggregated from their funding rounds, each with company profile fields, round count, round types, first and lat…
/api/v1/funding-rounds/companies/:companyKeyDetails
Returns an aggregated profile for a company in the funding rounds data: company details, round count, round types, first and latest round dates, late…
/api/v1/funding-rounds/statusStatus
Returns the current load state of the funding-rounds data, including its epoch state. Call it to check whether funding-round data is ready before que…
Market Sizing2 tools
/api/v1/market-sizingSearch
Returns a paginated list of market-sizing records with metadata (page, limit, totalItems, totalPages). Call it to browse or filter market-sizing data…
/api/v1/market-sizing/:keyDetails
Returns the market-sizing record for a single disease identified by its key. Call it when you already have a disease key and need its market-sizing d…
Medicare Spending2 tools
/api/v1/medicare-spendingSearch
Returns a paginated list of Medicare spending records with data and meta (page, limit, totalItems, totalPages). Call it to browse or filter spending…
/api/v1/medicare-spending/:keyDetails
Returns the full spending record for a single Medicare spending entry identified by its key. Call it when you already have a key from a spending sear…
Merged2 tools
/api/v1/merged/pathPath
Returns the boundary of a multi-step traversal starting from one or more start nodes, following the requested step sequence. Call it to walk relation…
/api/v1/merged/walkWalk
Traverses the merged graph from one or more starting nodes across the given edge types and returns the reached boundary nodes plus traversal metadata…
Papers3 tools
/api/v1/papersSearch
Returns a paginated list of papers, either browsed by publication date or matched against a text query. Call it to find papers by keyword, boolean ex…
/api/v1/papers/detailDetail
Returns a single paper record identified by DOI, arXiv/OSF-prefixed id, sanitized key, or PMID. Call it when you already have one paper identifier an…
/api/v1/papers/sampleSample
Returns a preview list of the five most recently published papers, ordered newest first, along with a sample size and a note. Call it to show a quick…
Supply Chain14 tools
/api/v1/supply-chain/dmfDmf
Returns a list of drug master file (DMF) records. Call it to browse or look up DMF entries. An empty list is a valid result, not an error.
/api/v1/supply-chain/dmf/:keyDetails
Returns the details of a single drug master file (DMF) identified by its key. Call it when you already have a DMF key and need that record's full det…
/api/v1/supply-chain/ema-gmdpEMA Gmdp
Returns a list of records from the EMA good manufacturing and distribution practice (GMDP) dataset. Call it to retrieve EMA GMDP entries; the respons…
/api/v1/supply-chain/ema-gmdp/:keyDetails
Returns the full record for a single EMA good manufacturing and distribution practice (GMDP) entry identified by its key. Call it when you already ha…
/api/v1/supply-chain/enforcementEnforcement
Returns a list of supply-chain enforcement records. Call it to retrieve enforcement actions relevant to regulatory or supply-chain compliance. Reques…
/api/v1/supply-chain/enforcement/:keyDetails
Returns the full details of a single supply-chain enforcement record identified by its key. Call it when you already have an enforcement key and need…
/api/v1/supply-chain/establishmentsEstablishments
Returns a list of establishment records from the supply-chain dataset. Call it to retrieve establishments for display or lookup. Rate-limited per day…
/api/v1/supply-chain/establishments/:keyDetails
Returns the full detail record for a single supply-chain establishment identified by its key. Call it when you already have an establishment key and…
/api/v1/supply-chain/facilities/:fei/drilldownDrilldown
Returns a drilldown view of a single supply-chain facility identified by its FEI. Call it when you already have a facility FEI and need its detailed…
/api/v1/supply-chain/facilities/globeGlobe
Returns a list of supply-chain facilities with their geographic locations, plus metadata giving the returned count, the total available, and whether…
/api/v1/supply-chain/inspectionsInspections
Returns a list of inspection records. Call it to retrieve inspections, for example to review regulatory inspection activity. No parameters are accept…
/api/v1/supply-chain/inspections/:keyDetails
Returns the full detail record for a single supply-chain inspection identified by its key. Call it when you already have an inspection key and need i…
/api/v1/supply-chain/searchSearch
Returns a paginated list of supply-chain records matching a full-text query, with metadata including total item count, total pages, and whether more…
/api/v1/supply-chain/walkWalk
Traverses the supply-chain graph from one or more starting nodes along the given edge types and returns the reached records plus a boundary and metad…
Trials Map3 tools
/api/v1/trials-map/hubsHubs
Returns the hub locations shown on the trials map, optionally narrowed by a search term and a stage. Call it to populate the map's hub markers or to…
/api/v1/trials-map/hubs/:city/sitesSites
Returns the trial sites for a hub city, optionally filtered by country, search term, stage, and coordinates. Call it to drill into a city's site loca…
/api/v1/trials-map/hubs/:city/sites/:siteName/trialsTrials
Returns the trials associated with a specific site within a city, with status and phase normalized. Call it to list trials for a named facility shown…
Virhostnet4 tools
/api/v1/virhostnet/factorsFactors
Returns a paginated list of viral/host factors, with each item plus metadata giving the current page, page size, total item count, and total page cou…
/api/v1/virhostnet/factors/:keyDetails
Returns the details of a single virus-host interaction factor identified by its key. Call it when you already have a factor key and need its full rec…
/api/v1/virhostnet/targets/:key/interactionsInteractions
Returns the virus-host interactions associated with a single VirHostNet target, identified by its key. Call it to list the interactions recorded for…
/api/v1/virhostnet/walkWalk
Returns the boundary of a graph traversal starting from one or more nodes and following the given edge types, with traversal metadata. Call it to exp…