Agent tool reference
Every tool available to Aimogen Pro AI Agents, what it does, its required parameters, and the risk each one carries.
Tools are selected per agent in the agent editor. The same set backs the chatbot extensions.
Risk grouping#
Read-only and safe: get_environment_info, get_wp_post_data, get_post_structure,
search_site_posts, wp_taxonomy_discovery, wp_validate_post_state, get_wp_media_info,
royalty_free_image_search, youtube_video_search, youtube_video_captions, rss_feed_parser,
google_results_parser, search_amazon, get_amazon_product_details, search_clickbank,
list_available_ai_agents, process_and_transform_data, pause_execution, generate_chart.
Modifies your site: manage_wp_post, edit_post_section, wp_sideload_media,
aimogen_rules_engine, aimogen_content_editor_templates.
Reaches outside your site: website_scraper, call_webhook, wp_send_email, and every
publish_* social tool.
High impact — treat as privileged: query_wp_database, read_server_file, write_server_file,
delegate_to_ai_agent.
The tools#
| Tool | What it does | Required parameters |
|---|---|---|
aimogen_rules_engine | List or execute bulk post creator rules, to create posts using AI, in the Aimogen plugin. | operation |
aimogen_content_editor_templates | Edit a post using AI, using the Aimogen plugin. List available AI Content Editor templates or apply a template to a WordPress post and edit it using it. | operation |
get_environment_info | Retrieve structured information about the current WordPress site. Includes environment, plugins, CPTs, taxonomies, and detected capabilities. Cannot be used to query posts. | info_type |
generate_chart | Generate and display charts dynamically using the [aiomatic_chat_charts] shortcode. Supports Bar, Line, and Pie charts, rendered as images for compatibility with WordPress posts, pages, and chatbot interfaces. Usage: [aiomatic_chat_charts type="bar/line/pie" title="ChartTitle"... | shortcode |
wp_send_email | Send an email to a specific recipient with a defined subject and HTML or text content. Use this when the task requires actually sending a message, not just drafting one. | recipient_email, subject, content |
website_scraper | Scrape and return the content of a specific website URL. Use this when you already have a target URL. Do not use for discovery or searching. | url |
rss_feed_parser | Parse an RSS feed URL and return structured feed items. Use this when the task requires reading recent feed entries from a blog, news source or podcast feed. | url |
google_results_parser | Search Google and return a list of search results including titles, snippets and URLs. Use this for discovery and finding relevant pages, not for scraping full page content. | keywords |
call_webhook | Call an external webhook using GET, POST, PUT or DELETE. Supports form_data or JSON payloads, plus optional custom headers. Use this when external automation or API communication is required. | webhook_url, method_selector |
search_clickbank | Search ClickBank for affiliate products matching a keyword query and return a product listing. Use this for discovery and comparison of candidate affiliate products. | query |
search_amazon | Search Amazon for products matching a keyword query and return a product listing. Use this for discovery, comparison or finding candidate products, not for deep product specs. | query |
get_amazon_product_details | Retrieve detailed information for a specific Amazon product by ASIN or precise product query. Use this after narrowing down the product, when you need specs, price, manufacturer or reviews. | query |
get_post_structure | Analyze a WordPress post and return its structure including headings, paragraphs and sections. Use this before editing to understand how the post is organized. | post_id |
edit_post_section | Edit a specific part of a WordPress post using an AI prompt. This tool modifies ONLY a defined section and preserves the rest of the content exactly as-is. Use this instead of rewriting entire posts. | post_id, section_selector, instruction |
manage_wp_post | Create, update, trash, restore, delete, duplicate and otherwise manage WordPress posts or pages. This is a high-impact content action and should be used only when the task explicitly requires changing site content. For the Create operation: post_title and post_content are required parameters. | none |
wp_taxonomy_discovery | Work with WordPress taxonomies and terms. IMPORTANT RULES: - Use ONLY one operation at a time. - Use ONLY the parameters required for that operation. - DO NOT include unused, empty, default, or irrelevant parameters. - DO NOT invent new operation names. - Valid operations are EXACTLY:... | operation |
wp_validate_post_state | Validate the current state of a WordPress post. Check if specific conditions are met such as having an excerpt, featured image, content length, status, or taxonomy. | post_id, checks |
get_wp_post_data | Retrieve the content, permalink, status and metadata of an existing WordPress post, page or product. Use this when the task requires reading or analyzing existing site content or obtaining its verified URL. | post_id |
process_and_transform_data | Safely transform structured data. Supports JSON parsing, extracting fields, filtering arrays, and simple mapping operations. No code execution. | operation, input |
pause_execution | Pause execution for a number of seconds. Useful for rate limits, API delays, or sequencing actions. | seconds |
search_site_posts | Search WordPress content with advanced filters and return each matching item's verified permalink. Use this to find drafts, products, missing images or custom field conditions. To find a live WooCommerce product link, use post_type product and post_status publish. Include ONLY parameters that... | none |
wp_sideload_media | Download an image from a remote URL and import it into the WordPress Media Library, optionally attaching it to a post. | image_url |
get_wp_media_info | Retrieve media information for a post or attachment. Can check featured image, list attachments, and validate media presence. | query |
youtube_video_captions | Retrieve the transcript or captions of a specific YouTube video by URL. Use this when the task requires summarizing, analyzing or extracting information from video speech. | url |
youtube_video_search | Search YouTube for videos based on a keyword phrase and return matching results. Use this to discover videos, then pass a chosen video URL to the captions tool if transcript analysis is needed. | keyword |
royalty_free_image_search | Search royalty free image sources using a short stock-photo keyword phrase, not an AI image prompt. Use 2-4 concrete words such as "domestic cat", "gaming laptop", or "team meeting". | keyword |
publish_facebook_post | Publish a text post or link to a selected Facebook page. | content |
publish_facebook_image | Publish an image with a caption to a selected Facebook page. | image_url |
publish_twitter_x_post | Publish a post to Twitter (X). | content |
publish_threads_post | Publish a post to Instagram Threads. | content |
publish_instagram_post | Publish a post to Instagram. | image_url |
publish_pinterest_post | Publish an image post to Pinterest boards. | image_url |
publish_google_my_business_post | Publish a post with an image to Google My Business. | image_url, content |
publish_youtube_community_post | Publish a text or image post to the YouTube Community tab. | post_type, content |
publish_reddit_post | Publish a new post to specified subreddits. | title, content |
publish_linkedin_post | Publish a post to LinkedIn with title, content and optional description, link and image. Use this only when the task explicitly requires posting to LinkedIn. | title, content |
list_available_ai_agents | Retrieve a list of all specialized sub-agents (e.g., SEO expert, Coder, Researcher) available for delegation. | agent_id, task |
delegate_to_ai_agent | Delegate a task to a more suitable agent if the task is outside your expertise. Use list_available_ai_agents first to discover available agents. When delegating a task, be as detailed as possible, also add any information you already have on the task, so the delegated agent will be able to... | agent_id, task |
read_server_file | Read the contents of a file on the server. Allowed file types: txt, csv, json, log. Use for reading data files, logs, or configurations. | file_path |
write_server_file | Write content to a secure sandbox folder inside uploads/aiomatic-exports. Only txt, log, csv, json, and md files are allowed. Use this for exporting reports, logs, datasets, or generated files. | filename, content |
query_wp_database#
Not in the table above because its description is generated at runtime. It executes SQL against the WordPress database, and its description tells the model which command types are permitted plus a schema map of your tables.
Permitted commands come from the chatbot setting
Database Command Types The AI Is Allowed To Execute, which defaults to SELECT only.
Notes on specific tools#
read_server_file and write_server_file are sandboxed to uploads/aiomatic-exports, and writing is
restricted to txt, log, csv, json and md. That is a real boundary, but the sandbox still lives in
your public uploads directory — do not have an agent write anything confidential there.
pause_execution lets the agent stop and wait, which pairs with the manual pause control added in
2.8.8.
edit_post_section and get_post_structure, added in 2.7.9, let an agent modify one section of a post
rather than rewriting the whole thing. Much safer than wholesale replacement.
Social publishing tools each require the matching CodeRevolution auto-poster plugin. See Social network posting.
delegate_to_ai_agent requires Allow delegation on the delegating agent. The receiving agent runs
with its own tools and step budget.
Custom tools#
Developers can register additional tools through the aiomatic_ai_functions filter. See
Custom AI tools and function calling.
Related#
Still stuck? Open a support ticket and include the diagnostics from Aimogen Pro › System & Logs › System Info.