Built-in Tools

Xagent ships with a library of built-in tools, organised by category. The planner selects from them automatically based on the task and the categories granted to an agent.

Basic Tools

web_search

Search the internet for current information — recent news, research, current data, and fact-checking.

Parameter	Type	Required	Description
query	string	Yes	The search query.
num_results	integer	No	Number of results (default 10).
include_content	boolean	No	Whether to include full page content.

python_executor

Execute Python safely for data analysis and computation — pandas transformations, matplotlib visualisation, and mathematical work.

Parameter	Type	Required	Description
code	string	Yes	Python code to execute.
libraries	array	No	Available libraries (pandas, numpy, matplotlib, …).

File & Image Tools

File tools (read_file, write/edit) let agents work with the task workspace — see File Management. Image tools depend on configured models:

Vision (understanding) — understand_images, describe_images, detect_objects require a vision model.
Image generation — generate_image, edit_image require an image generation model.

Discovering Tools

List the tools available to your account, including MCP-provided tools:

GET /api/tools/available     # all available tools, incl. MCP
GET /api/tools/configurable
GET /api/tools/usage         # tool usage statistics