Factors

virhostnetAvailable on FreeNo success wrapper

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 count. Call it to browse or enumerate factors, optionally narrowed to a single taxonomy. Invalid query parameters return HTTP 400; an unexpected server failure returns HTTP 500.

When to use it

List viral and host factors
Browse factors for a given taxonomy
Page through the factor catalog

Getting started

Base URL

https://app.caelrith.com/api/v1/tools

Authentication

Include your API key in the x-api-key header.

Rate limit

Every call counts against your workspace’s daily quota for biology-associations. Exceeding it returns HTTP 429.

Plans and daily limits

Plan	Available	Calls / day
free	yes	10
pro	yes	200
custom (default)	yes	10,000

Plan defaults. A custom workspace may carry per-tenant overrides.

Parameters

Query parameters

Parameter	Type	Required	Description
page	integer	No	Min 1; default 1 (min 1; default 1) Range: 1 to ∞
limit	integer	No	Range 1-100; default 20 (range 1-100; default 20) Range: 1 to 100
taxid	string	No	minimum length 1; maximum length 32

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/virhostnet/factors"

Response envelope

This endpoint returns an implicit 2xx response - there is no success flag in the body.

{
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

// No "success" flag on this endpoint - any 2xx JSON is a success.

Catalog version mcp-2026-10-28 · generated from the live MCP catalog