Trove · OpenAPI Overlay 1.0.0

Trove API v3: API Evangelist enhancements

16 actions 16 updates servers extends ../openapi/_original/trove-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Trove's API. It is a proposal applied on top of the contract, not a document Trove publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-agent-safex-idempotentx-mcp-toolserverssecurity

Targets 15

$.paths['/v3/result'].get

$.paths['/v3/work/{workId}'].get

$.paths['/v3/magazine/titles'].get

$.paths['/v3/magazine/title/{id}'].get

$.paths['/v3/people/{id}'].get

$.paths['/v3/list/{id}'].get

$.paths['/v3/newspaper/{id}'].get

$.paths['/v3/newspaper/titles'].get

$.paths['/v3/newspaper/title/{id}'].get

$.paths['/v3/gazette/{id}'].get

$.paths['/v3/gazette/titles'].get

$.paths['/v3/gazette/title/{id}'].get

$.paths['/v3/contributor'].get

$.paths['/v3/contributor/{id}'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: 'Trove API v3: API Evangelist enhancements'
  version: 1.0.0
extends: ../openapi/_original/trove-openapi.yml
x-generated: '2026-10-21'
x-method: generated
x-source:
- openapi/trove-openapi.yml
- https://api.trove.nla.gov.au/v3/trove-api-v3.yaml
actions:
- target: $
  description: 'The spec declares servers [{url: /}], relative to where it is hosted. It is hosted at https://api.trove.nla.gov.au/v3/trove-api-v3.yaml,
    and every path already begins with /v3, so the absolute server is the host root.'
  update:
    servers:
    - url: https://api.trove.nla.gov.au
      description: Trove API (host of the provider-published spec)
- target: $
  description: Apply the documented X-API-KEY scheme globally
  update:
    security:
    - ApiKey: []
- target: $.paths['/v3/result'].get
  description: Mark search as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: search
- target: $.paths['/v3/work/{workId}'].get
  description: Mark getWork as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getWork
- target: $.paths['/v3/magazine/titles'].get
  description: Mark findMagazineTitles as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: findMagazineTitles
- target: $.paths['/v3/magazine/title/{id}'].get
  description: Mark getMagazineTitle as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getMagazineTitle
- target: $.paths['/v3/people/{id}'].get
  description: Mark getPersonOrOrg as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getPersonOrOrg
- target: $.paths['/v3/list/{id}'].get
  description: Mark getList as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getList
- target: $.paths['/v3/newspaper/{id}'].get
  description: Mark getNewspaperArticle as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getNewspaperArticle
- target: $.paths['/v3/newspaper/titles'].get
  description: Mark findNewspaperTitles as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: findNewspaperTitles
- target: $.paths['/v3/newspaper/title/{id}'].get
  description: Mark getNewspaperTitle as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getNewspaperTitle
- target: $.paths['/v3/gazette/{id}'].get
  description: Mark getGazetteArticle as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getGazetteArticle
- target: $.paths['/v3/gazette/titles'].get
  description: Mark findGazetteTitles as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: findGazetteTitles
- target: $.paths['/v3/gazette/title/{id}'].get
  description: Mark getGazetteTitle as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getGazetteTitle
- target: $.paths['/v3/contributor'].get
  description: Mark findContributors as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: findContributors
- target: $.paths['/v3/contributor/{id}'].get
  description: Mark getContributor as a read-only, idempotent, agent-safe call
  update:
    x-agent-safe: true
    x-idempotent: true
    x-mcp-tool: getContributor

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/trove-openapi-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.