Search

papersAvailable on FreeNo success wrapper

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 expression, category, or date window. Combining a search with any sort other than relevance returns HTTP 400; invalid query parameters also return 400, and unexpected failures return 500.

When to use it

Search papers by keyword
Browse recent papers by publication date
Filter papers by category and date range

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 papersApiCallsPerDay. 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
search	string	No	Free-text phrase to match against papers.
boolean_search	string	No	Boolean query expression; when supplied it takes precedence over search.
category	string	No	Category to restrict results to.
date_from	string	No	Start of the publication date window, as an ISO date (YYYY-MM-DD).
date_to	string	No	End of the publication date window, as an ISO date (YYYY-MM-DD).
page	number	No	Min 1; default 1 (min 1; default 1) Range: 1 to ∞
limit	number	No	Range 1-100; default 20 (range 1-100; default 20) Range: 1 to 100
sort	string	No	Result ordering; relevance is only valid together with a search. Allowed values: published_date, relevance
order	string	No	Default desc (default desc) Allowed values: asc, desc

Example request

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

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