How to integrate Judge.me MCP with Hermes

Connect Hermes to Judge.me MCP. List recent reviews for your store, reply to negative product reviews politely, and more using natural language, with authentication handled for you.

Judge.me logoJudge.me
Oauth2

Judge.me is a product and shop review platform for online stores. It helps merchants collect, manage, and display trusted customer feedback.

34 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Judge.me account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Judge.me with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Judge.me with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Judge.me

Ask your agent to connect to Judge.me, or simply request any Judge.me-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Judge.me connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Judge.me or request any Judge.me-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Judge.me MCP server, and what's possible with it?

The Judge.me MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Judge.me account. It provides structured and secure access to your reviews, shop data, reviewer records, settings, rendered widgets, and webhooks, so your agent can monitor feedback, manage review visibility, respond to customers, retrieve store ratings, and maintain review integrations on your behalf.

  • Review monitoring and ratings: Have your agent list and count reviews, filter them by product, reviewer, rating, or publication status, and retrieve overall or shop-only ratings.
  • Review replies and visibility: Let the agent publish public or private replies, and publish, hide, archive, or restore individual reviews or groups of reviews.
  • Storefront review content: Direct your agent to retrieve product review widgets, rating badges, featured review carousels, all-reviews pages, reviews tabs, and other Judge.me display content.
  • Reviewer and shop management: Instruct your agent to find or update reviewer records, request reviewer data, read shop details and settings, and update supported shop metadata.
  • Webhook administration: Have your agent create, list, update, or delete Judge.me webhooks for events and callback URLs.

Way Forward

With Judge.me connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Judge.me action and event your agent gets out of the box.

Bulk Create Webhooks

Create multiple webhook subscriptions in one request.

Bulk Update Review Visibility

Sequentially publish, hide, archive, or unarchive 1-25 reviews.

Count Reviews

Count management review records, optionally filtered by reviewer, product, and star rating.

Count Storefront Reviews

Return the storefront aggregate review count for either all product and shop-level reviews or only shop-level reviews.

Create Checkout Comment

Persist a customer's comment for a product through Judge.

Create Private Review Reply

Create a private reply to a review and, by default, email it to the reviewer.

Create Public Review Reply

Post a public reply to a review and optionally email it to the reviewer.

Create Review

Submit a public web review in the background; no review is created when the shop disables web reviews.

Create Webhook

Create one webhook subscription for a Judge.

Delete Webhook

Delete the webhook subscription matching its current Judge.

Get All Reviews Page Widget

Return rendered HTML for one page of the shop's all-reviews page.

Get Checkout Comments Widget

Return rendered Checkout Comments widget HTML for one product; requires the Checkout Comments app.

Get Current Shop

Return identity, plan, platform, owner, and widget metadata for the OAuth-connected shop.

Get Featured Reviews Carousel

Return the rendered HTML for the shop's featured-reviews carousel.

Get Product

Return a product by Judge.

Get Product Preview Badge

Return the rendered rating-and-review-count badge HTML for one product.

Get Product Review Widget

Return the rendered review-widget HTML for one product and, optionally, one review page.

Get Review

Return one review by its Judge.

Get Reviewer

Return a reviewer by Judge.

Get Reviews Rating

Return the average rating for all product and shop-level reviews or for shop-level reviews only.

Get Reviews Tab Widget

Return the rendered floating reviews-tab HTML for a selected review type and page.

Get Settings

Return values for one or more named Judge.

Get Verified Reviews Badge

Return the rendered verified-review-count badge, or null when the shop has fewer than 20 verified reviews.

Get Webhook

Return one webhook subscription by its Judge.

Get Widget Placeholder HTML

Return the rendered placeholder HTML used before Judge.

Get Widget Settings HTML

Return the shop's rendered widget customization script and style HTML, not structured setting values.

List Reviews

Return one page of reviews, optionally filtered by reviewer, product, rating, published-only state, or reviewer email.

List Webhooks

Return all webhook subscriptions configured for the connected shop.

Request Reviewer Data

Submit a reviewer data request for a customer email and one or more external order IDs.

Uninstall Shop

WARNING: This uninstalls Judge.

Update Current Shop

Update selected profile and commerce metadata for the OAuth-connected shop.

Update Review Visibility

Publish, hide, archive, or unarchive a review.

Update Webhook

Replace a webhook subscription's event key and callback URL.

Create or Update Reviewer

Create or update a reviewer selected by Judge.

FAQ

Frequently asked questions

With a standalone Judge.me MCP server, the agents and LLMs can only access a fixed set of Judge.me tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Judge.me and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Judge.me tools.

Yes, absolutely. You can configure which Judge.me scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Judge.me data and credentials are handled as safely as possible.

Start with Judge.me.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Judge.me tool your agent needs.Free to start.

Start building