# Disqus ```json { "name": "Disqus", "slug": "disqus", "url": "https://composio.dev/toolkits/disqus", "markdown_url": "https://composio.dev/toolkits/disqus.md", "logo_url": "https://logos.composio.dev/api/disqus", "categories": [ "collaboration & communication" ], "is_composio_managed": false, "updated_at": "2026-10-02T05:32:04.481Z" } ``` ![Disqus logo](https://logos.composio.dev/api/disqus) ## Description 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. ## Summary 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. ## Categories - collaboration & communication ## Toolkit Details - Tools: 148 ## Images - Logo: https://logos.composio.dev/api/disqus ## Authentication - **Oauth2** - Type: `oauth2` - Description: Oauth2 authentication for Disqus. - Setup: - Configure Oauth2 credentials for Disqus. - Use the credentials when creating an auth config in Composio. ## Suggested Prompts - Summarize latest comments on a thread - Moderate reported comments and take action - List top threads by activity this week ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `DISQUS_ADD_BLACKLIST_ENTRY` | Add Blacklist Entry | Adds an entry to the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_ADD_FORUM_MODERATOR` | Add Forum Moderator | Adds a moderator to a forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_ADD_ORGANIZATION_ADMIN` | Add Organization Admin | Adds an admin to an organization. Updates permissions of existing admins too. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_ADD_WHITELIST_ENTRY` | Add Whitelist Entry | Adds an entry to the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_APPROVE_POSTS` | Approve Posts | Approves the requested post(s). Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_APPROVE_THREAD` | Approve Thread | Approve the specified moderated threads. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' or 'link' query types instead of an ID by including 'forum'. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_AWARD_BADGE` | Award Badge | Used to award badges to users manually. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_BACKFILL_BLACKLIST_COUNTERS` | Backfill Blacklist Counters | Triggers Disqus's parameterless blacklist-counter backfill endpoint. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_BAN_POST_AUTHOR_FROM_FORUM` | Ban Post Author From Forum | Ban the author of a post using the selected user, email, IP, shadow-ban, and retroactive-action options. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_BULK_CREATE_INTERNAL_FORUM_ACTION_HISTORY` | Bulk Create Internal Forum Action History | Creates many ActionHistory rows for backfilling from a JSON-encoded list of row dictionaries. Each row can identify the source row and carry action, forum, actor, target, thread, post, IP, date, rule, and blacklist or whitelist metadata. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role. | | `DISQUS_CHECK_AND_UPDATE_USERNAME` | Check And Update Username | Updates username for the user, fails if username does not meet requirements, or is taken by another user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_CLOSE_THREADS` | Close Threads | Closes a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon. The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_CREATE_CATEGORY` | Create Category | Creates a new category. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_CREATE_FORUM` | Create Forum | Creates a new forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_CREATE_FORUM_TRUSTED_DOMAIN` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_CREATE_INTERNAL_FORUM_ACTION_HISTORY` | Create Internal Forum Action History | Creates an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; the live OAuth account reached it, but OAuth admin scope did not confer that staff role. | | `DISQUS_CREATE_POST` | Create Post | Creates a new post as the authenticated OAuth user. Anonymous author fields are intentionally unavailable because Disqus forbids author_* parameters for authenticated callers. An ip_address override uses server-side application-secret authentication and requires moderator permission. The state and date fields also require moderator permission; state skips pre-approval validation. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_CREATE_THREAD` | Create Thread | Creates a new thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_CREATE_THREAD_REACTION_IMAGES` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_DELETE_INTERNAL_FORUM_ACTION_HISTORY` | Delete Internal Forum Action History | Deletes an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role. | | `DISQUS_DELETE_SSO_USER` | Delete Sso User | Deletes an SSO user account and their comment history. This performs a full GDPR-style deletion: the user account is deactivated and all associated posts are removed. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_DELETE_THREAD_REACTION_IMAGES` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_DISABLE_FORUM_ADS` | Disable Forum Ads | Disable advertising for the specified forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_DISMISS_AET_BANNER` | Dismiss Aet Banner | Records the authenticated user's dismissal of the AET banner for a forum, changing that user's banner state. If the user has already accepted or dismissed it, Disqus returns HTTP 400 with error code 2. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_EXPORT_AET_OPTOUTS` | Export Aet Optouts | Export opt-out records collected for a forum, either all records or those since the last partial export. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_EXPORT_AET_SUBSCRIBERS` | Export Aet Subscribers | Export subscribed users in either csv or json format. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_EXPORT_FORUM` | Export Forum | Start an export for the specified forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_EXPORT_ORGANIZATION_AUDIT_LOG` | Export Organization Audit Log | Export the audit log for the specified organization. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_FOLLOW_FORUM` | Follow Forum | Follow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_FOLLOW_USER` | Follow User | Follow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GENERATE_INTERESTING_FORUM_CONTENT` | Generate Interesting Forum Content | Internal only endpoint that causes the interesting content (forums) to be generated, but not returned. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_APPLICATION_USAGE` | Get Application Usage | Returns the API usage per day for this application. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_CATEGORY` | Get Category | Returns category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_CUSTOMER_PULSE_METADATA` | Get Customer Pulse Metadata | Returns Customer Pulse metadata available to the authenticated application; this endpoint takes no input. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_CUSTOMER_PULSE_SEGMENT` | 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. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_FORUM` | Get Forum | Returns forum details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_FORUM_BEHIND_CLICK_SETTING` | 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. | | `DISQUS_GET_FORUM_CATEGORY` | Get Forum Category | Returns forum category details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_FORUM_REACTION_CONFIG` | Get Forum Reaction Config | Used to load any configured reactions for the forum, and all active images belong to that forum. Also returns whether thread reactions are enabled for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_IMPORT` | Get Import | Return details for an import group. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_ORGANIZATION_BILLING_INFORMATION` | Get Organization Billing Information | Returns billing information related to an organization. This is in a dictionary with keys: `paymentInfo` (optional): `invoiceHistory`: Historical invoices that were successfully paid Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_GET_ORGANIZATION_CURRENT_PLAN` | Get Organization Current Plan | Return the current SaaS plan for an organization and product. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_GET_PAGE_BY_THREAD` | Get Page By Thread | Returns a page by thread id. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_PENDING_AET_EXPORT` | Get Pending Aet Export | Returns pending AET subscriber-export status for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_PENDING_AET_OPTOUT_EXPORT` | Get Pending Aet Optout Export | Returns pending AET opt-out-export status for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_POST` | Get Post | Returns information about a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_POST_CONTEXT` | Get Post Context | Returns the hierarchical tree of a post (all parents). asc - oldest first desc - newest first popular - highest upvote rating over time. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_THREAD` | Get Thread | Returns thread details. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_THREAD_RATINGS_SUMMARY` | Get Thread Ratings Summary | Returns average and total ratings for a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_THREAD_REACTION_DEFAULT_IMAGES` | Get Thread Reaction Default Images | Returns the metadata of the default reactions. This way they can display for forums that don't use reactions. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_GET_THREADS_BY_IDS` | Get Threads By Ids | Returns an unsorted set of threads given a list of ids. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_GET_USER` | Get User | Returns details of a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_AWARDED_BADGES` | List Awarded Badges | Returns one page of awarded badges for the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_BADGES` | List Badges | Used to load any configured badges for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_BLACKLIST_ENTRIES` | List Blacklist Entries | Returns one page of blacklist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_CATEGORIES` | List Categories | Returns one page of categories from the categories/list endpoint across the supplied forum IDs. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_CATEGORIES_IN_FORUM` | List Categories In Forum | Returns one page of categories from the forums/listCategories endpoint for one forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_CATEGORY_POSTS` | List Category Posts | Returns one page of posts within a category. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_CATEGORY_THREADS` | List Category Threads | Returns one page of threads within a category, sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_CLASSIFIED_FORUMS_NEEDING_FAVICONS` | 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. | | `DISQUS_LIST_FORUM_CATEGORIES` | 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. | | `DISQUS_LIST_FORUM_FOLLOWERS` | List Forum Followers | Returns one page of users following a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_FORUM_MODERATORS` | List Forum Moderators | Returns a list of all moderators on a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_FORUM_POSTS` | List Forum Posts | Returns one page of posts within a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_FORUM_THREADS` | List Forum Threads | Returns one page of threads within a forum, sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_LIST_FORUM_TRUSTED_DOMAINS` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_FORUM_USER_MODERATION_HISTORY` | List Forum User Moderation History | Returns one page of moderation history for a given user on a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_HOT_THREADS` | List Hot Threads | Returns a list of threads sorted by hotness (date and likes). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_IMPORTS` | List Imports | Return one page of imports for a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_INTERESTING_FORUMS` | List Interesting Forums | Return forums selected by the interesting-forums action. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_INTERESTING_USERS` | List Interesting Users | Returns a list of interesting users. This is not personalized to the user making the request. The selection of users is pulled randomly from a list of ~100 interesting users Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_MOST_ACTIVE_FORUM_USERS` | List Most Active Forum Users | Returns one page of users active within a forum, ordered by most comments made. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_MOST_LIKED_FORUM_USERS` | List Most Liked Forum Users | Returns one page of users active within a forum, ordered by most likes received. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_ORGANIZATION_ROLES` | List Organization Roles | List all users with elevated roles in an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_PAGES` | List Pages | Returns one page of category objects with hot-thread page data for forums in each category. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_POPULAR_POSTS` | List Popular Posts | Returns one page of posts ordered by recent likes. Pagination defaults to limit 25 and offset 0. Caveats: This beta endpoint is subject to change. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_POPULAR_THREADS` | List Popular Threads | Returns a list of threads sorted by number of posts made since ``interval``. If you are using both ``category`` and ``forum`` parameters, the forum of the category must match that as the parameter value for ``forum``. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_POST_MODERATION_HISTORY` | List Post Moderation History | Returns one page of moderation history for a given post. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_POST_REPORTERS` | List Post Reporters | Return users who reported the specified moderated posts. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_POSTS` | List Posts | Returns one page of posts ordered by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_RANDOM_PAGES` | List Random Pages | Returns a random list of category objects with page data of HotThreads for forums in that given category. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_SAAS_PACKAGES` | List Saas Packages | Return SaaS packages available to the specified organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_LIST_THREAD_POSTS` | List Thread Posts | Returns one page of posts within a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_THREAD_REACTIONS` | List Thread Reactions | Used to load the configured reactions for a thread. Also returns which reactions, if any, are selected by the user, as well as the eligibility of the thread for thread-reactions. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_THREADS` | List Threads | Returns one page of threads sorted by creation date. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_LIST_TRENDING_THREADS` | List Trending Threads | Returns a list of trending threads. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_ACTIVE_FORUMS` | List User Active Forums | Returns one page of forums a user has been active on. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_ACTIVITY` | List User Activity | Returns one page of activity made by the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_FOLLOWERS` | List User Followers | Returns one page of users following a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_FOLLOWING` | List User Following | Returns one page of users a user is following. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_FOLLOWING_CHANNELS` | List User Following Channels | Returns one page of channels a user is following. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_FOLLOWING_FORUMS` | List User Following Forums | Returns one page of forums a user is following. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_FORUMS` | List User Forums | Returns one page of forums a user owns. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_MODERATED_CHANNELS` | List User Moderated Channels | Returns one page of channels that the user moderates. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_MOST_ACTIVE_FORUMS` | List User Most Active Forums | Returns forums a user has recently been active on, sorted by the user's activity. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_OWNED_CHANNELS` | List User Owned Channels | Returns one page of channels that the user owns. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USER_POSTS` | List User Posts | Returns one page of posts made by the user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_USERS_WHO_VOTED_ON_THREAD` | List Users Who Voted On Thread | Returns a list of users that voted on this thread. If prioritize_followed is True and the user is authenticated, attempts to return users that the authenticated user follows. If there aren't enough followed users to reach the limit, pads the rest of the list with not followed users. Caveats: Prioritize followed users who voted on this thread (must be authenticated) The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_LIST_WHITELIST_ENTRIES` | List Whitelist Entries | Returns one page of whitelist entries. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_MARK_POSTS_AS_SPAM` | Mark Posts As Spam | Marks the requested post(s) as spam. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_OPEN_THREADS` | Open Threads | Opens a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon. The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_REMOVE_BADGE` | Remove Badge | Used to remove badges from users. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_BLACKLIST_ENTRY` | Remove Blacklist Entry | Removes an entry from the blacklist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_FORUM_DEFAULT_AVATAR` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_FORUM_MODERATOR` | Remove Forum Moderator | Removes a moderator from a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_FORUM_TRUSTED_DOMAIN` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_ORGANIZATION_ADMIN` | Remove Organization Admin | Removes an admin from an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_POSTS` | Remove Posts | Deletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_THREADS` | Remove Threads | Removes a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon. The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_REMOVE_USER_FOLLOWER` | Remove User Follower | Remove a user from set of followers. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REMOVE_WHITELIST_ENTRY` | Remove Whitelist Entry | Removes an entry from the whitelist. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REPLACE_FORUM_BADGES` | Replace Forum Badges | Used to update the configured badges for a forum. Badges are passed in as an array of badge objects, some of which have IDs. Badges that have IDs will be updated in the database while badges without IDs will be created. All other existing badges for the forum will be deleted. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REPORT_POST` | Report Post | Reports a post (flagging). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_REPORT_USER` | Report User | Report the specified user for the selected reason. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_RESTORE_POSTS` | Restore Posts | Undeletes the requested post(s). Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_RESTORE_THREADS` | Restore Threads | Calls Disqus's restore endpoint for the requested threads; the provider describes the effect as opening a thread. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' query type instead of an ID by including 'forum'. You may pass us the 'link' query type to filter by URL. You must pass the 'forum' if you do not have the Pro API Access addon. The official action page does not identify a billing tier; availability remains capability/account dependent. A forum selector is required when the account lacks the Pro API Access addon where the relevant parameter description says so. | | `DISQUS_SAVE_FORUM_THREAD_REACTION_TEMPLATE` | Save Forum Thread Reaction Template | Used to save a new configuration for thread reactions for a forum. Also enables threads reactions for the forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SET_ORGANIZATION_ROLE` | Set Organization Role | Add a user with an arbitrary role to an organization. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SET_THREAD_REACTIONS_FOR_FORUM` | Set Thread Reactions For Forum | Enables thread reactions for a forum, or disables them when requested. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SET_THREAD_REACTIONS_FOR_THREAD` | Set Thread Reactions For Thread | Disables thread reactions for a thread, or enables them when requested. This is primarily a per-thread override of the forum configuration. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SPAM_THREAD` | Spam Thread | Mark the specified moderated threads as spam. Caveats: Looks up a thread by ID You must be a moderator on the selected thread's forum. You may pass us the 'ident' or 'link' query types instead of an ID by including 'forum'. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SUBSCRIBE_ANONYMOUS_USER_TO_AET` | Subscribe Anonymous User To Aet | Allows an anonymous user to subscribe to AET banner for a forum. If the user has already accepted before, a 400 will be returned with 2 as the error code. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SUBSCRIBE_ORGANIZATION_TO_SAAS` | Subscribe Organization To Saas | Subscribe an organization to the specified SaaS pricing option, optionally using a coupon or activation code. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_SUBSCRIBE_THREAD` | Subscribe Thread | Subscribe the authenticated user to a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SUBSCRIBE_TO_AET` | Subscribe To Aet | Allows an authenticated user to subscribe to AET for a forum. If the user has already accepted/dismissed before, a 400 will be returned with 2 as the error code. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_SUGGEST_POSTS` | Suggest Posts | Return Apothecary suggestions for the specified posts. Caveats: Looks up a post by ID You must be a moderator on the selected post's forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_TOGGLE_BADGE_AWARD_VISIBILITY` | 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. | | `DISQUS_UNFOLLOW_FORUM` | Unfollow Forum | Unfollow a forum. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UNFOLLOW_USER` | Unfollow User | Unfollow a user. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UNSUBSCRIBE_ORGANIZATION_FROM_SAAS` | Unsubscribe Organization From Saas | Unsubscribe an organization from a SaaS product, immediately or at the documented default time. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_UNSUBSCRIBE_THREAD` | Unsubscribe Thread | Unsubscribe the authenticated user from a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_FORUM` | Update Forum | Updates forum details. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_FORUM_BEHIND_CLICK_SETTING` | 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. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_FORUM_DEFAULT_AVATAR` | Update Forum Default Avatar | Automatically crops avatar to the largest centered square and saves as the forum's default avatar. Returns the updated 92px avatar url. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_FORUM_FAVICON` | Update Forum Favicon | Update the favicon for the specified forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_INTERNAL_FORUM_ACTION_HISTORY` | Update Internal Forum Action History | Updates an ActionHistory row for backfilling. Caveats: The billing tier is undocumented. This endpoint requires a DISQUS-internal administrator role; OAuth admin scope does not confer that staff role. | | `DISQUS_UPDATE_ORGANIZATION_INVOICE_INFORMATION` | Update Organization Invoice Information | Update information that appears in invoices we send to customers for stripe charges. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_UPDATE_ORGANIZATION_PAYMENT_INFORMATION` | Update Organization Payment Information | Update an organization's payment information using the supplied payment token. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_UPDATE_POST` | Update Post | Updates information on a post. Star ratings update can also be passed on post update Caveats: You must be the author of the post or a moderator on the applicable forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_SSO_USER_PROFILE` | Update Sso User Profile | Updates SSO user profile attributes. url: The URL that will be displayed on the user profile profile_url: The URL that will be used to link to the user profile Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_THREAD` | Update Thread | Updates information on a thread. Caveats: You must be the author of the post or a moderator on the applicable forum. You must be a moderator on the applicable forum to change a thread author. You may look up a user by username using the 'username' query type. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_TOPIC` | Update Topic | Update the specified topic using the documented topic fields. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_UPDATE_USER_PROFILE` | Update User Profile | Updates user profile. All fields are optional, but any field not present will be updated as blank. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_VALIDATE_FORUM_SETTINGS` | Validate Forum Settings | Validate the documented settings for a moderator-managed forum. Caveats: Looks up a forum by ID (aka short name) You must be a moderator on the selected forum. The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_VALIDATE_ORGANIZATION_COUPON` | Validate Organization Coupon | Looks up a coupon string and validates against redeem_by and max_redemptions using CouponValidator. Returns serialized Coupon object or error message. Caveats: Looks up an organization by ID You must be an admin on the selected organization. The official action page does not identify a billing tier; availability remains capability/account dependent. This SaaS/billing action may require organization billing capability even though the page does not name a paid tier. | | `DISQUS_VOTE_POST` | Vote Post | Register a vote on a post. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_VOTE_THREAD` | Vote Thread | Register a vote on a thread. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | | `DISQUS_VOTE_THREAD_REACTION` | Vote Thread Reaction | Used to vote on a reaction. Caveats: The official action page does not identify a billing tier; availability remains capability/account dependent. | ## Supported Triggers None listed. ## Installation and MCP Setup ### Path 1: SDK Installation #### Path 1, Step 1: Install Composio Install the Composio SDK ```python pip install composio_openai ``` ```typescript npm install @composio/openai ``` #### Path 1, Step 2: Initialize Composio and Create Tool Router Session Import and initialize Composio client, then create a Tool Router session ```python from openai import OpenAI from composio import Composio from composio_openai import OpenAIResponsesProvider composio = Composio(provider=OpenAIResponsesProvider()) openai = OpenAI() session = composio.create(user_id='your-user-id') ``` ```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'); ``` #### Path 1, Step 3: Execute Disqus Tools via Tool Router with Your Agent Get tools from Tool Router session and execute Disqus actions with your Agent ```python tools = session.tools response = openai.responses.create( model='gpt-4.1', tools=tools, input=[{ 'role': 'user', 'content': 'YOUR_SPECIFIC_PROMPT_HERE' }] ) result = composio.provider.handle_tool_calls( response=response, user_id='your-user-id' ) print(result) ``` ```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); ``` ### Path 2: MCP Server Setup #### Path 2, Step 1: Install Composio Install the Composio SDK for Python or TypeScript ```python pip install composio claude-agent-sdk ``` ```typescript npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp ``` #### Path 2, Step 2: Initialize Client and Create Tool Router Session Import and initialize the Composio client, then create a Tool Router session for Disqus ```python from composio import Composio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions composio = Composio(api_key='your-composio-api-key') session = composio.create(user_id='your-user-id') url = session.mcp.url ``` ```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}`); ``` #### Path 2, Step 3: Connect to AI Agent Use the MCP server with your AI agent (Anthropic Claude or Mastra) ```python import asyncio options = ClaudeAgentOptions( permission_mode='bypassPermissions', mcp_servers={ 'tool_router': { 'type': 'http', 'url': url, 'headers': { 'x-api-key': 'your-composio-api-key' } } }, system_prompt='You are a helpful assistant with access to Disqus tools.', max_turns=10 ) async def main(): async with ClaudeSDKClient(options=options) as client: await client.query('YOUR_SPECIFIC_PROMPT_HERE') async for message in client.receive_response(): if hasattr(message, 'content'): for block in message.content: if hasattr(block, 'text'): print(block.text) asyncio.run(main()) ``` ```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}`); ``` ## Why Use Composio? ### 1. 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 ### 2. 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 ### 3. 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 ### 4. 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 ## Use Disqus with any AI Agent Framework Choose a framework you want to connect Disqus with: - [ChatGPT](https://composio.dev/toolkits/disqus/framework/chatgpt) - [Claude Cowork](https://composio.dev/toolkits/disqus/framework/claude-cowork) - [Hermes](https://composio.dev/toolkits/disqus/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/disqus/framework/atomic-agent) ## Related Toolkits - [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable. - [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management. - [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place. - [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action. - [Microsoft teams](https://composio.dev/toolkits/microsoft_teams) - Microsoft Teams is a collaboration platform that combines chat, meetings, and file sharing within Microsoft 365. It keeps distributed teams connected and productive through seamless virtual communication. - [Slackbot](https://composio.dev/toolkits/slackbot) - Slackbot is a conversational automation tool for Slack that handles reminders, notifications, and automated responses. It boosts team productivity by streamlining onboarding, answering FAQs, and managing timely alerts—all right inside Slack. - [2chat](https://composio.dev/toolkits/_2chat) - 2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers. - [Agent mail](https://composio.dev/toolkits/agent_mail) - Agent mail provides AI agents with dedicated email inboxes for sending, receiving, and managing emails. It empowers agents to communicate autonomously with people, services, and other agents—no human intervention needed. - [Android Texter](https://composio.dev/toolkits/android_texter) - Android Texter is an API service that connects Android phones to SMS, MMS, contacts, and device data. Use it to automate mobile messaging without building your own phone-to-API bridge. - [Basecamp](https://composio.dev/toolkits/basecamp) - Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place. - [Blooio](https://composio.dev/toolkits/blooio) - Blooio is a stable v2 API platform for messaging, chats, contacts, groups, phone numbers, and account analytics. It gives teams a clean way to build reliable communication workflows without stitching together fragile custom APIs. - [CallOnTheGo](https://composio.dev/toolkits/callonthego) - CallOnTheGo is a telephony API for managing phone numbers, caller IDs, suppression lists, audio assets, contact lists, and Voice AI campaigns. It provides programmatic control over calling infrastructure and campaign automation for scalable voice outreach. - [Carbon Voice MCP](https://composio.dev/toolkits/carbon_voice_mcp) - Carbon Voice MCP is a voice-first collaboration platform for messages, conversations, and workflows. Use it to centralize voice communications and streamline team collaboration. - [CardClan](https://composio.dev/toolkits/cardclan) - CardClan is a digital card platform for creating and sending personalized team cards. Use it to celebrate moments, share card links, and manage card workflows without extra coordination. - [Chatwork](https://composio.dev/toolkits/chatwork) - Chatwork is a team communication platform with group chats, file sharing, and task management. It helps businesses boost collaboration and streamline productivity. - [Clickmeeting](https://composio.dev/toolkits/clickmeeting) - ClickMeeting is a cloud-based platform for running online meetings and webinars. It helps businesses and individuals host, manage, and engage virtual audiences with ease. - [Confluence](https://composio.dev/toolkits/confluence) - Confluence is Atlassian's team collaboration and knowledge management platform. It helps your team organize, share, and update documents and project content in one secure workspace. - [Daily](https://composio.dev/toolkits/daily) - Daily is a WebRTC video and audio API platform for building rooms, meetings, recordings, live streams, transcriptions, and telephony. It gives developers reliable real-time media infrastructure without managing complex conferencing stacks. - [Dailybot](https://composio.dev/toolkits/dailybot) - DailyBot streamlines team collaboration with chat-based standups, reminders, and polls. It keeps work flowing smoothly in your favorite messaging platforms. - [Dialmycalls](https://composio.dev/toolkits/dialmycalls) - Dialmycalls is a mass notification service for sending voice and text messages to contacts. It helps teams and organizations quickly broadcast urgent alerts and updates. ## Frequently Asked Questions ### Do I need my own developer credentials to use Disqus with Composio? Yes, Disqus requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you. ### Can I use multiple toolkits together? Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview). ### Is Composio secure? Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev). ### What if the API changes? Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)