Disqus MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Disqus MCP or direct API to moderate comments, summarize threads, post replies, and manage users through natural language.

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

Try Disqus now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Disqus
Try asking
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.

SETUP GUIDE

Connect Disqus MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Disqus
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Disqus API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Disqus Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Disqus actions with your Agent

Why Use Composio?

AI Native Disqus Integration

  • Supports both Disqus MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Disqus data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Disqus access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Disqus
  • Scoped, least privilege access to Disqus resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Disqus requires connections to go through your own OAuth app. You register it once with Disqus, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Disqus as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Disqus connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Disqus account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Disqus as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Disqus lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Disqus administrator may need to approve the app first, and you can revoke the access inside Disqus whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Disqus connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Disqus tokens automatically, so day to day you do nothing. If you revoke access inside Disqus, or Disqus invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Disqus use. Paid plans add higher limits and team features. Your Disqus plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Disqus accounts).

With Composio, you connect Disqus once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Disqus.It takes 30 seconds.

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

Start building