How to Use the Discourse MCP in Windsurf

Q: How do I configure the Discourse MCP Server in Windsurf?

Open your Windsurf settings and add the server to your mcpconfig.json file under the mcpServers key. Cascade automatically detects the 10 available tools upon reloading.

Q: Do I need admin access to use this?

Most tools like listforumcategories require only standard public access. You only need administrative API credentials if you plan to run listactivemembers.

Run complex community tracking routines using the Discourse MCP Server to auto-chain forum lookups in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Discourse MCP to Windsurf

Create your Vinkius account to connect Discourse to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Discourse with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run autonomous forum audits with the Discourse MCP Server

`list_latest_topics` pulls recent discussions while Cascade chains subsequent lookups to map user activity. The system executes sequential checks across your forum categories without asking for manual confirmation at every step. You specify the target metric, and the agent coordinates `list_trending_discussions` and `get_topic_details` to build an activity report. It handles the entire sequence of API calls in a single run.

Map community groups and member lists

`list_community_groups` retrieves the group structure of your forum to identify key segments. Your agent can immediately pass those results to `list_group_members` to build a complete directory of specific cohorts. This integration bypasses manual dashboard navigation entirely. Cascade resolves the relationships between groups and individual accounts in seconds.

Instant context retrieval for support issues

`search_community_content` scans your public and private channels to find existing answers to user problems. The agent pulls the exact post content using `get_topic_details` to verify if a solution is still valid. This setup lets you verify forum history before drafting new replies. You get the full thread context directly in your workspace.

Setup guide

Set up Discourse MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Discourse MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Discourse payment history." If connected, Cascade will call the Discourse tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "discourse-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Discourse. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Discourse now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Discourse MCP in Windsurf

Open your Windsurf settings and add the server to your `mcp_config.json` file under the `mcpServers` key. Cascade automatically detects the 10 available tools upon reloading.

Yes, Cascade plans and executes multi-step sequences natively. For example, it can call `list_latest_topics` and then run `get_topic_details` for each thread without requiring separate prompts.

The server passes API rate limit headers back to Windsurf. Cascade manages the pacing of requests to avoid triggering blocks during deep forum scans.

Most tools like `list_forum_categories` require only standard public access. You only need administrative API credentials if you plan to run `list_active_members`.

Your API tokens and forum post data stay inside the V8 sandbox. Vinkius processes these requests on ephemeral runners, meaning your credentials are never stored or logged on disk.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript