Skip to main content
GET
A name to one id, before any filter

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string
required

A name, @handle, YouTube URL or channel id (UC...). One thing per call.

Minimum string length: 2
type
enum<string>

Restrict candidates to one type. Pass channel for a show and read best.youtube_channel_id.

Available options:
person,
organization,
product,
topic,
channel
limit
integer
default:8

Candidates to return, 1 to 15. Default 8.

Required range: 1 <= x <= 15
context
string

What the user said about the name, in their words ("the startup bank", "Canada's prime minister", "on My First Million"). Ranks candidates by their description and by the episodes they share with what the context names; a clear winner comes back as suggested with reason context.

Required string length: 2 - 300
src
enum<string>

The surface making this call. The Arcmira MCP server sends mcp-tool so every unlock link in a gate attributes to the directory install. Omit from your own client.

Available options:
mcp-tool

Response

Success

query
string
required

The q parameter echoed back.

context
string | null
required

The context parameter echoed back.

confidence
enum<string>
required

exact: one entity is named q (or the handle, id or alias), and no better-known person carries the name. single_fuzzy: the only entity returned, not an exact name. ambiguous: several exact matches, or an exact match next to a better-known person sharing the name (Jordan the brand vs Michael Jordan). fuzzy: only loose matches. none: no match.

Available options:
exact,
single_fuzzy,
ambiguous,
fuzzy,
none
best
object | null
required

The one entity q means. Set on exact and single_fuzzy only. Name it in the answer.

suggested
object | null
required

Set when best is null but one entity stands out, with the reason and evidence. Use it and tell the user you assumed it.

ask
object | null
required

Set when best and suggested are both null and several entities fit: show the options to the user, or check every option id against the data and answer per entity.

candidates
(object | null)[]
required

Entities considered: exact names first, then initials, whole-word, spelling and substring matches, each by appearance count.

The one entity q means. Set on exact and single_fuzzy only. Name it in the answer.

note
string
required

One steering sentence for the agent reading this.