The Merchant OS agents, what each does, and its tools
The Merchant OS agents, what each does, and its tools.
Authorization
HTTPBearer JWT access token
In: header
Query Parameters
Optional merchant to act on. Must be one you are a member of.
uuidHeader Parameters
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/agents/catalogue"{ "data": [ {} ], "meta": {}, "success": true}Ask the Growth Scientist POST
Runs the LangGraph workflow: intent analysis, deterministic metric gathering, specialist fan-out, evidence synthesis and a structured recommendation. Works without an LLM key - the figures and the recommendation are deterministic either way, only the prose is simpler.
Ask the Merchant OS (Orchestrator -> specialist agent -> approval gate) POST
The Orchestrator Agent routes the request to Business Intelligence, Product Discovery, Supply Intelligence, Pricing Intelligence, Growth Strategy or the PayPal Transaction Agent. Every tool call is permission-checked, traced and recorded. Nothing that moves money happens without a human approval.