For tools and AI agents: this page as Markdown · the public OpenAPI file
Description
Without appId, it returns the apps that match query, or popular apps when there is no query. With appId, it returns that app's full detail: its operations with their parameters, and how to call one from a flow's app_action step. Apps that run through a step type of their own name it in builtInNodes.
Permission
Needs an API key or OAuth connection with the build permission.
Input
| Name | Type | Required | Description |
|---|---|---|---|
query | string | No | Free-text search over app name/id/description. Omit to list popular apps. |
appId | string | No | Return full detail (including operations) for this single app id. |
limit | number | No | Max results for a search (default 25, max 100). |
Returns
A search returns count and apps (each with id, name, tier, category, description and hasOperations). One app returns id, name, tier, category, description, baseUrl, authType, authNote, docUrl, operations and appActionHint.
Errors
Returned as a normal result with isError: true:
No app found with id "<appId>".
Returned as a JSON-RPC error:
| Code | HTTP | Message |
|---|---|---|
| -32001 | 403 | API key lacks the 'build' permission required for flow authoring tools |
Messages are shown exactly as the server sends them, in English. A value in angle brackets is filled in at run time.
Examples
Example call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "exo_search_apps",
"arguments": {
"query": "qoyod",
"limit": 1
}
}
}curl -X POST https://exomations.com/api/mcp \
-H "X-Api-Key: exo_your_key" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"exo_search_apps","arguments":{"query":"qoyod","limit":1}}}'Example result
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Found 1 app(s) matching \"qoyod\". Pass appId to one of these to see its operations.\n{ ... }"
}
],
"structuredContent": {
"count": 1,
"apps": [
{
"id": "qoyod",
"name": "Qoyod",
"tier": "native",
"category": "finance",
"description": "Saudi cloud accounting (ZATCA e-invoicing). ...",
"hasOperations": true
}
]
},
"isError": false
}
}Example values. In content, the text after the summary line is the same data as structuredContent.