How to use expl
- Check the connection first: run expl server status. Exit code 0 from expl server tools list does not mean the connection works.
- Find commands instead of guessing names: run
expl server tools list --json, then expl server tools describe <tool_name> for the arguments of one command. - Add
--jsonand read the result from standard output. Progress and warnings go to standard error, so they do not break the JSON. - Read the exit code. 3 means the server cannot be reached, and 4 means authentication or permission.
- Outside a terminal, an operation that is hard to undo does nothing without
--yes(exit code 2). Ask the user before you add--yes, and add it only for an operation the user has decided to run. expl server token revoke is an exception: it sends the revocation without asking and without--yes, so confirm the key and the user’s intention to revoke it before you run it. - In CI, sign in with an API key through the environment variable EXPL_SERVER_TOKEN.
- When an error message names a tool, such as chart_query, run expl server tools describe <tool_name> to see the command for that tool.
Choose expl or MCP Server
MCP is a shared standard for AI tools to connect to outside services. You can use Exploratory from AI with either.
To read published content from an AI tool, see MCP Server. To work with projects in Exploratory Desktop, see Use with Desktop.
