The Bettermode MCP server lets you connect your community to AI tools such as Claude, ChatGPT, and Cursor. Once connected, you can work with your community using natural language.
For example, you can ask:
“Which spaces had no new posts in the last 7 days?”
Your AI tool calls the appropriate Bettermode tools to retrieve the answer. With your approval, it can also take supported actions, such as publishing a post, sending a direct message, assigning a badge, or hiding spam.
The MCP server is available to admins only and excludes destructive actions by design. It cannot delete spaces, members, or your community, or change a space from public to private.
Every action runs under a real member identity. This means posts and messages created through your AI tool appear as if they were created by the admin associated with the connector.
Key Concepts
Before setting up a connection, it helps to understand how Bettermode uses MCP:
MCP (Model Context Protocol) — An open standard that lets AI tools connect to external products. Claude, ChatGPT, and Cursor support MCP.
Connector — The connection between your AI tool and your Bettermode community. Each connector has a scope—read-only or read + write—and a token tied to the admin who authorized it.
Read tools — Tools that retrieve community data, such as spaces, posts, members, badges, and analytics, without making changes.
Write tools — Tools that make changes to your community, such as creating a post, sending a direct message, assigning a badge, adding members to a space, or hiding a post. Each write requires your approval.
Acting identity — The member identity the connection uses when performing actions. You can ask your AI tool to call bettermode_whoami to verify the acting member and connector scope.
Before You Start
Before connecting an AI tool to Bettermode:
You need admin access to your community.
Your AI tool must support custom MCP connectors.
MCP is available on all plans.
Starter is limited to 10 MCP requests per day per connector.
Growth and Premium have unlimited MCP usage within the standard API rate limits.
Connect an AI Tool to Bettermode
Go to Administration → App store → MCP.
Copy the connection URL. There is nothing to generate on the Bettermode side. Bettermode automatically selects the correct region based on your community's data residency:
US communities use
https://mcp.bettermode.com/EU communities use
https://mcp.bettermode.de/
In your AI tool, go to Settings → Connectors → Add custom connector, paste the connection URL, and authorize the connection.
Choose the scope during authorization. The scope is selected in your AI tool's authorization flow, not in Bettermode:
Read-only: Lets the AI tool retrieve community data without making changes.
Read + write: Lets the AI tool retrieve data and perform supported actions under your identity.
Configure the tool permissions:
Set read tools to Always Allow.
Set write tools to Needs Approval.
Your AI tool can now access the Bettermode tools available to the connector's scope.
Important: A read + write connector performs actions under the identity of the admin who authorized it.
Read Tools
Read tools retrieve information from your community without making changes. You can use them to work with spaces, posts, members, badges, post types, and analytics.
Tool
What It Does
bettermode_whoami
Shows which member the connection acts as and its scope.
bettermode_list_spaces
Lists spaces with post and member counts. Supports name search.
bettermode_list_space_posts
Lists recent posts in one or more spaces, newest first. Filters by creation date or last activity.
bettermode_search_posts
Searches posts by text and ranks results by relevance. Can be scoped to specific spaces or a time window.
bettermode_get_post
Retrieves one post with its full text, reaction counts, and replies.
bettermode_get_member
Looks up a member profile by ID or username.
bettermode_list_members
Lists members, newest first. Filters by join date and last-seen date.
bettermode_search_members
Searches members by name, username, or email.
bettermode_list_badges
Lists community badges with their type and active state.
bettermode_list_post_types
Lists the post types available in a space, or the reply types available for a post, with their fields.
bettermode_get_analytics
Counts posts, replies, reactions, views, or active members over a date range. Groups results by day, week, month, or space and can be scoped to one space.
Write Tools
Write tools make changes to your community and are available with a read + write connector. Your AI tool asks for approval before each write.
Tool
What It Does
bettermode_create_post
Creates and publishes a post in a space, or a reply to an existing post.
bettermode_send_message
Sends a direct message to a member. Creates the conversation if it doesn't exist yet.
bettermode_assign_badge
Assigns an existing badge to a member. One member per call.
bettermode_add_space_members
Adds existing community members to a space by member ID or email. Does not invite non-members.
bettermode_hide_post
Hides a post from the community or unhides a previously hidden post. This action is reversible.
Example: From Question to Action
You can combine read and write tools to retrieve information and then take action based on the results.
For example, ask:
“Find members who joined in the last 30 days and haven't posted, then send each a personalized check-in DM.”
Your AI tool can then:
Call
bettermode_list_membersand filter by join date.Cross-check each member's activity.
Draft a personalized message for each member.
Call
bettermode_send_messagefor each member.
Because sending a direct message is a write action, your AI tool asks for your approval before each message is sent.
Safeguards and Limits
The MCP server includes safeguards that limit what connected AI tools can do in your community:
Per-action approval: Every write tool call requires confirmation in your AI tool before it runs.
No destructive tools: The MCP server cannot delete spaces, members, or your community, or change a space from public to private.
One target per write: Direct messages and badge assignments apply to one member per call. For bulk actions, this surfaces one approval per member rather than one approval for the entire action.
Reversible moderation: Hiding a post is the strongest supported moderation action, and a hidden post can be unhidden.
Bounded queries: Analytics queries can cover up to 186 days per request. If a request is refused, try a shorter date range.
Paginated results: List tools return up to 50 items per page.
Rate limits: MCP requests count against a dedicated MCP balance and are subject to your plan's API rate limits.
Data Residency
The MCP server automatically matches your community's region.
Bettermode determines the region from your connector and routes requests to the in-region API. This means EU community data never transits a US process on the Bettermode side.
Data returned to the connected AI tool leaves Bettermode. Claude, ChatGPT, and Cursor are third-party services, and most are US-hosted.
FAQs and Troubleshooting
Why can't my AI tool perform a write action?
Check the connector scope. A read-only connector can retrieve information but cannot make changes to your community. Write tools require a read + write connector.
How do I check which member and scope my connection is using?
Ask your AI tool to call bettermode_whoami. It returns the member the connection acts as and its scope.
Why did my analytics request fail?
Analytics queries can cover up to 186 days per request. If your request exceeds this range, try a shorter date range.
Why am I not seeing all the results?
List tools return up to 50 items per page. Your AI tool may need to retrieve additional pages for larger result sets.
What happens if I reach the MCP request limit?
Starter is limited to 10 MCP requests per day per connector. Growth and Premium have unlimited MCP usage within the standard API rate limits.
How do I disconnect an AI tool?
Go to Administration → App store → MCP and revoke the connector. Revoking it immediately disconnects the connected AI tool.