unlob Docs
Browse documentation

authorities

Coverage Graph: the top passages about a topic (or entity), ranked by graph centrality rather than by match to a query.

Behaviour

Trust-triage a field you do not know yet — read the central sources first instead of reading junk into your context and discovering later that it was junk.

Arguments

inputSchema

NameTypeDescription
limitinteger
topicrequiredstringTopic tag, or an entity / salient term

Returns

A JSON payload in the text content block, and the same payload as structuredContent for clients that support it.

outputSchema

NameTypeDescription
facetsobjectPresent only when facets=true
moderequired"keyword" | "semantic" | "hybrid"The mode actually used
partialbooleantrue when at least one shard failed or timed out — the answer is short because a slice of the corpus was unreachable, NOT because that is all there is. Never treat a partial result as complete.
resultsrequiredobject[]
routedrequiredbooleantrue when the router chose the vertical, false when you named it
totalrequiredinteger
verticalstring | nullThe vertical actually queried

Calling it

Over Streamable HTTP, with the required arguments filled in:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "authorities",
    "arguments": {
      "topic": "<topic>"
    }
  }
}

Most clients do this for you — see Connect a client. To drive it by hand, complete the startup lifecycle first.