Who may call it, and what it costs
Price. Free. Every reply says what the call cost in
meta.costCredits. The prices are on Spending, tracking and stopping.
Arguments
names, domains, URLs, question wordings or typed ids (up to 25); match: “meaning” takes one text or qst_/top_/mkt_ id; the dictionary takes words to look for, or none; kinds argument takes tool names up to 25
what to match: brand, topic, question, market, page, site, place (default all); with match: “meaning” question, topic, market; or facet, surface, measure alone for the dictionary; argument alone, with tool names in q: what a tool takes beyond its tools/list entry up to 7
name (default): exact names, domains and ids; meaning: nearest in meaning, for a phrase with no exact match or to find what to track next
dictionary only: facets of this unit (answer, mention, evidence, comparison, page, page_brand, question, topic_brand)
Industry or category markets. For countries use country, and for cities use place. up to 50
GET /v1/tools serves it, every shared object written out; https://agent.parse.gl/openapi.json serves the same schema with the filter and the window named once under components and pointed to by $ref. MCP tools/list leaves out the arguments few calls send, and says the filter and the window once, under search_answers; resolve_ids {"kinds": ["argument"]} lists what it left out, and a call with any of them runs:
Example call
Find a brand by its domain, with its markets and whether Parse has enough on it. Over REST:- Find a place’s plc_ id:
{"q":["Austin, TX"],"kinds":["place"]} - Find the questions Parse already asks that mean the same:
{"q":["best project management tool for agencies"],"match":"meaning","kinds":["question"],"limit":5} - The dictionary: every field to filter and group by, every AI surface and every measure:
{"kinds":["facet"]} - Only the facets of a brand mention:
{"kinds":["facet"],"unit":"mention"} - The arguments search_answers takes beyond those its tools/list entry shows:
{"kinds":["argument"],"q":["search_answers"]}
data, context, next, page and meta; follow next for the calls that come after. A refused call returns { code, message, fix }: see the error table.