Use tool discovery when you know the source or task but do not know which operation to call. Discovery does not run the listed methods. You can inspect capabilities before performing a read or write.
Discover and inspect an operation
-
Find the source
Shell zortex manage --json '{"what":"sources"}'Locate the exact source ID, such as
gmail,google-drive,browser-use, orcua. Inspect its state. An unavailable or disabled source may need setup or recovery before it can execute anything.For shared actions that are not specific to an app, run
zortex actionswithout a source. That list gives names. Usezortex instructionand the Action reference for fixed inputs such as sharing; do not assume every shared action has a source-specific schema lookup. -
List its methods
Shell zortex actions --json '{"source":"gmail"}'Read the names and descriptions in the returned catalog. Choose the method that matches the intended operation and effect. Do not construct a method name from an app name.
Some catalogs accept
query,resource,limit,cursor, orprofile. Follow the installed tool and catalog's returned pagination information. Filtering one source's catalog is not a search of your messages or documents, and one page is not necessarily the whole catalog. -
Inspect the selected schema
Replace the placeholder with the exact method returned in step 2:
Shell zortex actions --json '{"source":"gmail","method":"<returned-method-name>"}'Check the required fields, accepted values, account/resource selectors, effect, and response description. If an operation changes data, verify that its target and scope match your task before invoking it. A readable schema does not prove the account has permission to execute it.
Sources with a shared bounded-read route can expose the schema for
connector.read:Shell zortex actions --json '{"source":"gmail","method":"connector.read"}'If that source does not offer it, use the method its actual catalog returned. Browser actions have their own fixed names and are invoked directly; provider and computer methods normally use
connector.invoke. -
Run the operation
Continue with Run an action. It explains the shared read path, provider invocation, result checks, and write recovery.
MCP equivalents
Text indra.manage({"what":"sources"}) indra.actions({"source":"gmail"}) indra.actions({"source":"gmail","method":"<returned-method-name>"})These are tool requests made by a connected agent, not terminal commands. MCP tool reference lists their arguments.
When discovery fails
| Symptom | What to check |
|---|---|
| Source is missing | Confirm the source ID and installed source inventory. Do not infer support from another installation. |
| Source is disabled | Preserve the setting unless enabling it is intended; see Permissions. |
| Catalog is empty | Check whether the source offers a shared read route or needs setup. Empty catalog is not a successful task. |
| Method was listed but schema lookup fails | Refresh the current catalog and use the exact name from the same source/profile. |
| Schema works but invocation fails | Read the operation error; connection, resource permissions, or required arguments can still be missing. |
You are ready to act when you have the current method name, its schema, the intended source/account, and the required input values.