SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Disqus MCP with Hermes

Connect Hermes to Disqus MCP. Summarize latest comments on a thread, moderate reported comments and take action, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Disqus logoDisqus
Oauth2

Disqus is a discussion and community platform for managing forums, threads, posts, users, moderation, and organization settings. It centralizes conversations and moderation tools so communities stay organized and healthy.

148 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 Disqus 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 Disqus with

ChatGPTClaude CoworkAtomic Agent

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 Disqus 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 Disqus

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

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

5. Done!

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

The Disqus MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Disqus account. It provides structured and secure access so your agent can perform Disqus operations on your behalf.

Way Forward

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

Add Blacklist Entry

Adds an entry to the blacklist.

Add Forum Moderator

Adds a moderator to a forum.

Add Organization Admin

Adds an admin to an organization.

Add Whitelist Entry

Adds an entry to the whitelist.

Approve Posts

Approves the requested post(s).

Approve Thread

Approve the specified moderated threads.

Award Badge

Used to award badges to users manually.

Backfill Blacklist Counters

Triggers Disqus's parameterless blacklist-counter backfill endpoint.

Ban Post Author From Forum

Ban the author of a post using the selected user, email, IP, shadow-ban, and retroactive-action options.

Bulk Create Internal Forum Action History

Creates many ActionHistory rows for backfilling from a JSON-encoded list of row dictionaries.

Check And Update Username

Updates username for the user, fails if username does not meet requirements, or is taken by another user.

Close Threads

Closes a thread.

Create Category

Creates a new category.

Create Forum

Creates a new forum.

Create Forum Trusted Domain

Adds a trusted domain to a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Create Internal Forum Action History

Creates an ActionHistory row for backfilling.

Create Post

Creates a new post as the authenticated OAuth user.

Create Thread

Creates a new thread.

Create Thread Reaction Images

Used to save custom reactions that an admin creates Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Delete Internal Forum Action History

Deletes an ActionHistory row for backfilling.

Delete Sso User

Deletes an SSO user account and their comment history.

Delete Thread Reaction Images

Used to delete custom reactions of a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Disable Forum Ads

Disable advertising for the specified forum.

Dismiss Aet Banner

Records the authenticated user's dismissal of the AET banner for a forum, changing that user's banner state.

Export Aet Optouts

Export opt-out records collected for a forum, either all records or those since the last partial export.

Export Aet Subscribers

Export subscribed users in either csv or json format.

Export Forum

Start an export for the specified forum.

Export Organization Audit Log

Export the audit log for the specified organization.

Follow Forum

Follow a forum.

Follow User

Follow a user.

Generate Interesting Forum Content

Internal only endpoint that causes the interesting content (forums) to be generated, but not returned.

Get Application Usage

Returns the API usage per day for this application.

Get Category

Returns category details.

Get Customer Pulse Metadata

Returns Customer Pulse metadata available to the authenticated application; this endpoint takes no input.

Get Customer Pulse Segment

Returns a bounded Customer Pulse segment snapshot available to the authenticated application; this endpoint takes no input and may truncate deeply nested segment values to stay within the tool response limit.

Get Forum

Returns forum details.

Get Forum Behind Click Setting

Returns forum custom behind-a-click settings Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Get Forum Category

Returns forum category details.

Get Forum Reaction Config

Used to load any configured reactions for the forum, and all active images belong to that forum.

Get Import

Return details for an import group.

Get Organization Billing Information

Returns billing information related to an organization.

Get Organization Current Plan

Return the current SaaS plan for an organization and product.

Get Page By Thread

Returns a page by thread id.

Get Pending Aet Export

Returns pending AET subscriber-export status for a forum.

Get Pending Aet Optout Export

Returns pending AET opt-out-export status for a forum.

Get Post

Returns information about a post.

Get Post Context

Returns the hierarchical tree of a post (all parents).

Get Thread

Returns thread details.

Get Thread Ratings Summary

Returns average and total ratings for a thread.

Get Thread Reaction Default Images

Returns the metadata of the default reactions.

Get Threads By Ids

Returns an unsorted set of threads given a list of ids.

Get User

Returns details of a user.

List Awarded Badges

Returns one page of awarded badges for the user.

List Badges

Used to load any configured badges for the forum.

List Blacklist Entries

Returns one page of blacklist entries.

List Categories

Returns one page of categories from the categories/list endpoint across the supplied forum IDs.

List Categories In Forum

Returns one page of categories from the forums/listCategories endpoint for one forum.

List Category Posts

Returns one page of posts within a category.

List Category Threads

Returns one page of threads within a category, sorted by creation date.

List Classified Forums Needing Favicons

Gets forums that are classified in tempest (primarily means has a high quality score and is in english) Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

List Forum Categories

Returns a list of forum categories Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

List Forum Followers

Returns one page of users following a forum.

List Forum Moderators

Returns a list of all moderators on a forum.

List Forum Posts

Returns one page of posts within a forum.

List Forum Threads

Returns one page of threads within a forum, sorted by creation date.

List Forum Trusted Domains

Returns a list of forum trusted domains Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

List Forum User Moderation History

Returns one page of moderation history for a given user on a forum.

List Hot Threads

Returns a list of threads sorted by hotness (date and likes).

List Imports

Return one page of imports for a forum.

List Interesting Forums

Return forums selected by the interesting-forums action.

List Interesting Users

Returns a list of interesting users.

List Most Active Forum Users

Returns one page of users active within a forum, ordered by most comments made.

List Most Liked Forum Users

Returns one page of users active within a forum, ordered by most likes received.

List Organization Roles

List all users with elevated roles in an organization.

List Pages

Returns one page of category objects with hot-thread page data for forums in each category.

List Popular Posts

Returns one page of posts ordered by recent likes.

List Popular Threads

Returns a list of threads sorted by number of posts made since ``interval``.

List Post Moderation History

Returns one page of moderation history for a given post.

List Post Reporters

Return users who reported the specified moderated posts.

List Posts

Returns one page of posts ordered by creation date.

List Random Pages

Returns a random list of category objects with page data of HotThreads for forums in that given category.

List Saas Packages

Return SaaS packages available to the specified organization.

List Thread Posts

Returns one page of posts within a thread.

List Thread Reactions

Used to load the configured reactions for a thread.

List Threads

Returns one page of threads sorted by creation date.

List Trending Threads

Returns a list of trending threads.

List User Active Forums

Returns one page of forums a user has been active on.

List User Activity

Returns one page of activity made by the user.

List User Followers

Returns one page of users following a user.

List User Following

Returns one page of users a user is following.

List User Following Channels

Returns one page of channels a user is following.

List User Following Forums

Returns one page of forums a user is following.

List User Forums

Returns one page of forums a user owns.

List User Moderated Channels

Returns one page of channels that the user moderates.

List User Most Active Forums

Returns forums a user has recently been active on, sorted by the user's activity.

List User Owned Channels

Returns one page of channels that the user owns.

List User Posts

Returns one page of posts made by the user.

List Users Who Voted On Thread

Returns a list of users that voted on this thread.

List Whitelist Entries

Returns one page of whitelist entries.

Mark Posts As Spam

Marks the requested post(s) as spam.

Open Threads

Opens a thread.

Remove Badge

Used to remove badges from users.

Remove Blacklist Entry

Removes an entry from the blacklist.

Remove Forum Default Avatar

Switches a forum to use the regular default avatar instead of a custom one Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Remove Forum Moderator

Removes a moderator from a forum.

Remove Forum Trusted Domain

Removes a trusted domain from a forum Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Remove Organization Admin

Removes an admin from an organization.

Remove Posts

Deletes the requested post(s).

Remove Threads

Removes a thread.

Remove User Follower

Remove a user from set of followers.

Remove Whitelist Entry

Removes an entry from the whitelist.

Replace Forum Badges

Used to update the configured badges for a forum.

Report Post

Reports a post (flagging).

Report User

Report the specified user for the selected reason.

Restore Posts

Undeletes the requested post(s).

Restore Threads

Calls Disqus's restore endpoint for the requested threads; the provider describes the effect as opening a thread.

Save Forum Thread Reaction Template

Used to save a new configuration for thread reactions for a forum.

Set Organization Role

Add a user with an arbitrary role to an organization.

Set Thread Reactions For Forum

Enables thread reactions for a forum, or disables them when requested.

Set Thread Reactions For Thread

Disables thread reactions for a thread, or enables them when requested.

Spam Thread

Mark the specified moderated threads as spam.

Subscribe Anonymous User To Aet

Allows an anonymous user to subscribe to AET banner for a forum.

Subscribe Organization To Saas

Subscribe an organization to the specified SaaS pricing option, optionally using a coupon or activation code.

Subscribe Thread

Subscribe the authenticated user to a thread.

Subscribe To Aet

Allows an authenticated user to subscribe to AET for a forum.

Suggest Posts

Return Apothecary suggestions for the specified posts.

Toggle Badge Award Visibility

Used to toggle the hidden status of a badge award across Disqus for a user Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent.

Unfollow Forum

Unfollow a forum.

Unfollow User

Unfollow a user.

Unsubscribe Organization From Saas

Unsubscribe an organization from a SaaS product, immediately or at the documented default time.

Unsubscribe Thread

Unsubscribe the authenticated user from a thread.

Update Forum

Updates forum details.

Update Forum Behind Click Setting

Sets the forum custom behind-a-click settings Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum.

Update Forum Default Avatar

Automatically crops avatar to the largest centered square and saves as the forum's default avatar.

Update Forum Favicon

Update the favicon for the specified forum.

Update Internal Forum Action History

Updates an ActionHistory row for backfilling.

Update Organization Invoice Information

Update information that appears in invoices we send to customers for stripe charges.

Update Organization Payment Information

Update an organization's payment information using the supplied payment token.

Update Post

Updates information on a post.

Update Sso User Profile

Updates SSO user profile attributes.

Update Thread

Updates information on a thread.

Update Topic

Update the specified topic using the documented topic fields.

Update User Profile

Updates user profile.

Validate Forum Settings

Validate the documented settings for a moderator-managed forum.

Validate Organization Coupon

Looks up a coupon string and validates against redeem_by and max_redemptions using CouponValidator.

Vote Post

Register a vote on a post.

Vote Thread

Register a vote on a thread.

Vote Thread Reaction

Used to vote on a reaction.

FRAMEWORKS

How to build Disqus MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Disqus MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Disqus MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Disqus MCP with Atomic Agent

FAQ

Frequently asked questions

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

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

Start with Disqus.It takes 30 seconds.

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

Start building