How to integrate Moderation API MCP with Hermes

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 Moderation API 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.

Moderation API logoModeration API
Api Key

Moderation API is a content safety service for detection, human review, author management, and moderation actions. Use it to keep user-generated content safer with clear workflows and audit-ready decisions.

11 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 Moderation API 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 Moderation API with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ 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 Moderation API 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 Moderation API

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

4. Done. You're all set with a new Moderation API 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 Moderation API or request any Moderation API-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Moderation API MCP server, and what's possible with it?

The Moderation API MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Moderation API account. It provides structured and secure access to your moderation workflows, review queues, actions, and wordlists, so your agent can evaluate content, submit items for review, inspect queues, resolve reviewed items, and apply moderation actions on your behalf.

  • Content policy evaluation: Have your agent evaluate content without storing it, then report policy findings and the recommended moderation action.
  • Content submission and review: Let the agent submit content for moderation so it can be retained and added to a review queue based on your project settings.
  • Review queue management: Direct your agent to check queue totals, list and filter moderation items, and mark reviewed items as resolved or pending.
  • Moderation action execution: Instruct your agent to view available moderation actions and apply the appropriate action to content or authors.
  • Wordlist management: Have your agent list wordlists, inspect their current words, and add or remove terms from an existing wordlist.

Way Forward

With Moderation API 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 Moderation API action and event your agent gets out of the box.

Evaluate Content Without Storage

Evaluate content without retaining it or adding it to a review queue, and return policy findings and the recommended moderation action.

Execute Moderation Action

Apply a discovered moderation action to content items or authors.

Get Account and Quota

Return the connected Moderation API account, plan, current project, and current quota values.

Get Review Queue

Return metadata and item counts for a review queue by ID.

Get Wordlist

Return one wordlist and its current words by ID.

List Moderation Actions

List moderation actions available to the organization, optionally restricted to a review queue.

List Review Queue Items

List and filter one page of moderation items in a review queue.

List Wordlists

List the organization's wordlists and their identifiers.

Modify Wordlist Words

Add words to or remove words from an existing wordlist.

Set Review Queue Item Status

Mark a review queue item resolved or return it to pending.

Submit Content for Moderation

Evaluate content and allow Moderation API to retain it and add it to a review queue according to the project's configuration.

FAQ

Frequently asked questions

With a standalone Moderation API MCP server, the agents and LLMs can only access a fixed set of Moderation API tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Moderation API 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 Moderation API tools.

Yes, absolutely. You can configure which Moderation API 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 Moderation API data and credentials are handled as safely as possible.

Start with Moderation API.It takes 30 seconds.

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

Start building