Agentmatica MCP Connector

By Agentmatica

0+ active installationsVersion 0.9.0

Free MCP connector for Agentmatica.com. Expose WordPress content and optional WooCommerce tools to Agentmatica visitor chat.

Description

Agentmatica MCP Connector is the official, free MCP connector for Agentmatica.

Agentmatica is a website visitor agent: it answers from your own pages, captures leads, and can take store actions when you connect tools. This plugin is the WordPress side of that connection. It is free to install from the WordPress plugin directory. You do not pay for the plugin.

You need an Agentmatica account to use the chat product. Agentmatica has a free plan (no credit card). Paid Agentmatica plans add higher reply limits and extra product features. All plugin code on your site stays available either way.

Developed by Thought Bulb.

What this plugin does

It runs an MCP (Model Context Protocol) server on your WordPress site so Agentmatica can use documented tools:

  • WordPress content (always on) — site info, published pages, published posts
  • WooCommerce (optional, when WooCommerce is installed) — catalog search, in-chat cart, checkout link, order lookup, merchant-gated post-purchase actions, and AI order attribution for Agentmatica Insights

Connect Agentmatica with:

  • The UCP MCP endpoint (/wp-json/agentmatica/v1/ucp/mcp)
  • An integration token (Bearer auth, amk_wp_ prefix for new tokens)
  • No WordPress username or application password

Requires WordPress 6.9 or later for the Abilities API used by the MCP server.

Setup guide: WordPress integration docs

External services

This plugin is a connector for the Agentmatica service.

  • Service: Agentmatica visitor chat and agent platform (terms, privacy)
  • When data is sent: Only after you connect this site in Agentmatica (endpoint + integration token), or when a WooCommerce order attributed to Agentmatica is completed
  • Data Agentmatica may read via MCP: published site content; with WooCommerce, catalog/cart data and (if you enable them) order lookup / post-purchase tools, using the integration token or a logged-in customer token
  • Data this plugin may POST to Agentmatica: for attributed WooCommerce orders, order id/number, total, currency, shop URL, conversation id, item count and a product summary (no customer data) to https://app.agentmatica.com/api/webhooks/woocommerce/order-attribution so revenue can appear in Agentmatica Insights
  • Product FAQs: only if you set an agent ID under Settings → Agentmatica and use the [agentmatica_faq] shortcode or the WooCommerce product page option. When a page shows FAQs, your server sends the agent ID, your site address (as the request origin) and that page’s URL to https://agentmatica.com/api/widget/session and https://agentmatica.com/api/widget/product-qa, and keeps the answers for 12 hours. No visitor data is sent.
  • Widget: the chat widget itself is loaded from Agentmatica when you paste the Deploy snippet on your site; this plugin does not inject that widget until you add the snippet

See PRIVACY.md in the plugin for local storage details.

Installation

  1. Install Agentmatica MCP Connector from Plugins → Add New, or upload the zip. Activate it. The plugin is free.
  2. Create a free Agentmatica account at agentmatica.com/signup if you do not have one.
  3. In WordPress, open Settings → Agentmatica and copy the UCP MCP endpoint and integration token.
  4. In Agentmatica → Integrations → WordPress, paste the token (and endpoint if asked). You can also use Detect MCP after a site crawl.
  5. Optional: install WooCommerce for catalog, chat cart, checkout, and post-purchase support.
  6. From Agentmatica Deploy, copy the WordPress PHP embed snippet onto your theme or a snippet plugin.

FAQ

Is this plugin free?

Yes. Installing and using this WordPress plugin is free. Agentmatica.com is a separate product with a free plan and optional paid plans.

Do I need Agentmatica.com?

Yes. This plugin is the MCP connector for Agentmatica visitor chat. Without an Agentmatica bot configured with your endpoint and token, the plugin still runs locally but nothing connects to it.

Do I need the WordPress MCP Adapter plugin?

No. This plugin ships its own UCP MCP server at /wp-json/agentmatica/v1/ucp/mcp.

Do I need WooCommerce?

No. WooCommerce enables catalog, cart, checkout, post-purchase support, and order attribution. WordPress content tools work without it.

Can the chat edit products or orders?

No, not as a store admin. Only published content, catalog reads, and visitor-scoped cart mutations are exposed by default. Post-purchase order writes (cancel, address update, return request) require a logged-in customer token and merchant-enabled toggles.

How do I show product FAQs?

Turn on Product FAQs in your Agentmatica dashboard. In WordPress, open Settings → Agentmatica, paste your agent ID from Agentmatica → Deploy, and save. Then add [agentmatica_faq] to a page, post or product description. On WooCommerce you can instead tick “Show FAQs on every WooCommerce product page”. The questions are printed as HTML with FAQPage structured data, so search engines and AI assistants can read them without running JavaScript. A page gets FAQs only after Agentmatica has crawled it.

Who develops this plugin?

Thought Bulb builds and maintains the plugin for Agentmatica.com.

How do I get support?

Read https://agentmatica.com/docs/integrations/wordpress or use the WordPress.org support forum for this plugin.

Screenshots

Changelog

0.9.0

  • New [agentmatica_faq] shortcode. It shows the questions and answers Agentmatica wrote for the current page, printed as HTML with FAQPage structured data so search engines and AI assistants can read them. Answers are kept for 12 hours. If Agentmatica can’t be reached, nothing is shown.
  • New Product FAQs settings: your agent ID, and an option (off by default) to show FAQs on every WooCommerce product page.

0.8.0

  • New [agentmatica_starters id=”…”] shortcode. It shows a group of starter questions from your Agentmatica dashboard on any page, post or product description. A click opens the chat with that question. The Agentmatica chat must be on the page.

0.7.5

  • Security: a signed-in shopper can only see and change orders placed from their own account. Orders are no longer matched by billing email for signed-in shoppers, because store accounts are not email-verified.
  • Security: logging out of the store ends the shopper’s verified chat session, and a verified chat session now lasts 15 minutes instead of 45.
  • Security: a customer token only links a chat to an account once Agentmatica has verified it, not when the token is issued.
  • Security: order-number lookups are limited per order number, so guessing the email for one order is capped.
  • Security: the storefront cart routes only accept requests from the store’s own pages.
  • Cancelling an order with a refund now sends the money back through the payment gateway. If the gateway cannot refund automatically, the order gets a note asking you to refund manually.
  • Asking for a return twice on the same order no longer emails you twice.

0.7.4

  • Cancel and return now require the shopper to be signed in to their store account, the same as shipping-address changes. Guests are passed to your team.
  • The customer-token route only accepts a fetch from the widget: images and other embedded requests on the store are refused, and an invalid nonce is never ignored.
  • The widget sends shoppers to your real My Account page, even if it is renamed, translated or in a subfolder.
  • Cart sync keeps each item’s chosen options and add-on data, and other plugins’ cart hooks keep working.
  • Cart routes cap a single line at 99.
  • Also in 0.7.3 but missing from its notes: catalog search matches plural words (“screens” finds “screen”), chat cart adds respect stock, and the chat cart stays in sync with the store cart.

0.7.3

  • Logged-in shoppers can get a customer token from the storefront widget. The route requires a wp_rest nonce or a same-origin fetch (not a clicked link).
  • Customer tokens only bind the chat session they were issued for.
  • Chat checkout links use the WooCommerce checkout URL with agentmatica_checkout.
  • Cancel and return can use order number + email verification. Changing a shipping address still requires a logged-in account.

0.7.2

  • WooCommerce search_catalog no longer loads the entire catalogue on each chat search (SQL + capped re-rank). Fixes timeouts on large shops.
  • get_product can resolve by product name when id is missing.
  • Checkout and storefront-cart REST routes register on rest_api_init.
  • An exact SKU search only returns published products.
  • Requires PHP 8.0. Earlier versions already needed it to load.

0.7.1

  • Fixed: order attribution was sent to an address that does not exist, so sales made through the chat were not counted in Agentmatica Insights.

0.7.0

  • Order attribution now also sends the order total, item count and a product summary (no customer data) so Agentmatica Insights can show average order value and the products the agent sold.
  • New Bearer-authenticated order-stats route returns completed order totals from WooCommerce analytics, for the agent’s share of store orders.
  • Fixed two cart error messages that used the wrong text domain and could not be translated.

0.6.2

  • Checkout hand-off links now carry a random single-purpose token instead of the chat session key; the public redirect only accepts that token.
  • Registered abilities now require the plugin’s Bearer integration token (or an administrator) instead of an always-true permission callback.
  • Static llms.txt / .well-known/ucp files are only written on plain-permalink sites, from admin-side events, via the WP_Filesystem API; pretty-permalink sites serve both routes dynamically and no root files are written.

0.6.1

  • WordPress.org listing copy: free MCP connector for Agentmatica.com, Thought Bulb as developer, fuller external-service disclosure.
  • Uninstall no longer fatals when cleaning public files (load compatibility classes before route cleanup).

0.6.0

  • Widget parity: persist UCP __ai_* cart attributes on chat cart and order meta; push completed orders to Agentmatica for Insights revenue.
  • Accept widget session keys (c_*) on transient chat carts.
  • Customer-token REST route for logged-in Woo shoppers (WISMO + post-purchase writes from embed snippet).
  • UCP cart create_cart / update_cart merge attribution attributes.

0.5.1

  • Add export_catalog_snapshot MCP tool for Agentmatica inventory-map generation.

0.5.0

  • WooCommerce post-purchase support on UCP MCP (WISMO + merchant-gated cancel / address / return request).

0.4.0

  • UCP 2026-04-08 MCP at /wp-json/agentmatica/v1/ucp/mcp; business profile at /.well-known/ucp.

0.3.0

  • Rename plugin package to agentmatica-wordpress; modular architecture; amk_wp_ integration tokens.