Tools reference
Every MCP tool TellMyShop gives Claude in your PrestaShop store: what it does, whether it reads or writes, and which block switches it on.
Read tools never change your store. Write tools first return a preview and a single-use token valid for 30 minutes; Claude saves only after you approve. The module starts in read-only mode, and the free Audit edition is that mode for good. No tool returns your customers' personal data. 44 tools in module 0.3.0.
Core · always on
Not a block in the module settings. Block number 0 is used here only so that every tool has an integer block. There is no Audit block in the code: the Audit edition is the module's read-only mode.
| Tool | What it does | Access | Connector |
|---|---|---|---|
| Get shop info ps_get_shop_info | Tells Claude what your shop is: PrestaShop version, languages, currency and what it is allowed to do. | Read-only | daily + service |
Block 1 · Content & SEO
On after install, but the whole module starts in read-only mode, so the write tools of this block stay hidden until read-only mode is turned off. Each group has its own switch. Blog tools appear only when SmartBlog is detected.
| Tool | What it does | Access | Connector |
|---|---|---|---|
| Check shop health ps_check_shop_health | Checks your shop for technical problems and says how to fix each one. | Read-only | daily |
| Diagnose product visibility ps_diagnose_product_visibility | Finds out why a product doesn't show up in the shop or in its category. | Read-only | daily |
| Read PrestaShop logs ps_get_logs | Reads the shop's error log, so Claude can tell you what went wrong and when. | Read-only | daily |
| List modules ps_list_modules | Lists the modules installed in your shop. | Read-only | daily |
| Search products ps_search_products | Finds products by name, reference, category or missing information. | Read-only | daily |
| Get product ps_get_product | Reads everything about one product: texts, prices, photos, categories. | Read-only | daily |
| Category tree ps_get_category_tree | Shows how your categories are arranged. | Read-only | daily |
| Get category ps_get_category | Reads the texts and settings of one category. | Read-only | daily |
| List features ps_list_features | Lists product features such as colour, material or size, and their values. | Read-only | daily |
| SEO audit ps_audit_seo | Checks products, categories and pages for missing or poor SEO texts. | Read-only | daily |
| Inspect a store page ps_inspect_page | Opens a page of your shop the way a visitor or Google sees it. | Read-only | daily |
| 404 report ps_get_404_report | Shows which addresses in your shop lead to a "page not found" error. | Read-only | daily |
| List CMS pages ps_list_cms_pages | Lists your information pages, such as Delivery, Terms or About us. | Read-only | daily |
| Get CMS page ps_get_cms_page | Reads the content of one information page. | Read-only | daily |
| List blog posts ps_list_blog_posts | Lists your blog posts (SmartBlog). | Read-only | daily |
| Get blog post ps_get_blog_post | Reads one blog post. | Read-only | daily |
| List blog categories ps_list_blog_categories | Lists your blog categories. | Read-only | daily |
| Product sales ps_get_product_sales | Shows which products sell best and how much they earned, without customer data. | Read-only | daily |
| List changes ps_list_changes | Shows what Claude changed in your shop and when. | Read-only | daily |
| Update product content ps_update_product_content | Changes product names, descriptions and SEO texts after you approve a preview. | Write · preview + approve | daily |
| Update category content ps_update_category_content | Changes category names, descriptions and SEO texts after you approve a preview. | Write · preview + approve | daily |
| Set product categories ps_set_product_categories | Moves products into or out of categories. | Write · preview + approve | daily |
| Set product features ps_set_product_features | Fills in product features such as colour or material. | Write · preview + approve | daily |
| Change URL (slug) ps_change_url | Changes a page address and makes sure the old address redirects to the new one. | Write · preview + approve | daily |
| Update image alt text ps_update_image_legends | Writes descriptions (alt texts) for product photos. | Write · preview + approve | daily |
| Update CMS page ps_update_cms_page | Changes the text of an information page. | Write · preview + approve | daily |
| Save blog post ps_save_blog_post | Writes a new blog post or edits an existing one. | Write · preview + approve | daily |
| Update blog category ps_update_blog_category | Changes the name and description of a blog category. | Write · preview + approve | daily |
| Revert change ps_revert_change | Undoes a change Claude made. | Write · preview + approve | daily |
Block 2 · Commerce (off by default)
Prices, promotions, voucher codes, stock, carriers (read). Off after install.
| Tool | What it does | Access | Connector |
|---|---|---|---|
| Update prices ps_update_prices | Changes product prices. Big jumps need your extra approval. | Write · preview + approve | daily |
| Manage sale prices (specific prices) ps_manage_specific_prices | Sets up, lists or removes sale prices for chosen dates. | Write · preview + approve | daily |
| Manage cart rules and voucher codes ps_manage_cart_rules | Creates discount codes and switches them on or off. New codes start switched off. | Write · preview + approve | daily |
| Update stock ps_update_stock | Changes how many items you have in stock. | Write · preview + approve | daily |
| List carriers ps_list_carriers | Shows your delivery options, their prices and free-delivery thresholds. | Read-only | daily |
Block 3 · Appearance & deployments (service connector, off by default)
Theme files, backups, cache, child theme, module template overrides, hook positions. Only through the service connector, which works only from allowlisted IP addresses. Off after install.
| Tool | What it does | Access | Connector |
|---|---|---|---|
| List theme files ps_list_theme_files | Lists the files that make up your shop's look. | Read-only | service |
| Read theme file ps_read_theme_file | Reads one file of your shop's look. | Read-only | service |
| Write theme file ps_write_theme_file | Changes a file of your shop's look, with a backup made first. | Write · preview + approve | service |
| List file backups ps_list_file_backups | Lists the backups of look files. | Read-only | service |
| Restore file backup ps_restore_file_backup | Brings back an earlier version of a look file. | Write · preview + approve | service |
| Clear cache ps_clear_cache | Clears the cache so recent changes show up on the site. | Write · preview + approve | service |
| Create child theme ps_create_child_theme | Creates a child theme that holds your changes, so theme updates don't wipe them. | Write · preview + approve | service |
| Override module template ps_override_module_template | Changes how a module looks without touching the module itself. | Write · preview + approve | service |
| Manage hook positions ps_manage_hook_positions | Changes where on the page modules appear and in what order. | Write · preview + approve | service |
Roadmap
Planned, not in the module yet. These are not tools and have no pages.
- OAuth sign-in for the connector Block
Replace the static token in the connector URL with OAuth. A token in a URL can end up in server and proxy logs. OAuth is also expected for a listing in Claude's connector directory.
- Licence check in the module Block
Licence gate before each call (active, grace, inactive), licence section in the configuration screen, background refresh, release on uninstall. No or invalid licence switches the module to read-only mode, which already hides all write tools. Integration points: specification section 7.
- Customer data switch Block
A separate switch for tools that could return personal data. Not confirmed in the 0.3.0 code review. Today the tools simply return no customer data (sales without customers, logs with masked emails and phones).
- Multistore settings and licensing Block
Settings are global in 0.3.0; tools already accept shop_id. Per-shop settings and per-domain licence activation still need a design.