How to Use the Illumidesk MCP in Windsurf

Q: How do I connect the Illumidesk MCP Server to Windsurf?

Open your Windsurf settings and add the server to your mcpconfig.json file. You can also use the built-in marketplace for a one-click install. Cascade detects the tools instantly on startup.

Q: Can Windsurf chain multiple Illumidesk tools to provision a course?

Yes. Cascade handles multi-step tasks by running listcampuses first, selecting the target ID, and then pulling course details with getcourse automatically. You only provide the high-level goal.

Q: How does Windsurf handle API rate limits when pulling Illumidesk logs?

The client paces requests when fetching data via getactivitylogs. If you hit a limit, the agent waits and retries the call. This prevents your admin token from getting temporarily blocked.

Manage Illumidesk campuses, courses, and LTI setups directly inside Windsurf using Cascade's autonomous multi-step actions.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Illumidesk MCP to Windsurf

Create your Vinkius account to connect Illumidesk 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 Illumidesk with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map out and verify Illumidesk campus structures

This integration uses `list_campuses` and `get_campus` to pull your entire organizational layout into your workspace. Your agent reads this data to map out exactly where your courses live. It stops you from guessing database IDs or hunting down campus parameters manually. Once it grabs the core structure, Cascade automatically triggers `list_courses` to build a complete index of active classes. You don't have to prompt it for every single step. It chains these tools together to give you a clean, updated view of your teaching environments in seconds.

Automate course enrollment audits in Windsurf

The MCP Server exposes `list_memberships` and `list_users` to audit student rosters and instructor access across any active course. Your agent scans these lists to find missing enrollments or unauthorized accounts. It matches names against your local files without requiring manual export steps. If a student reports a login issue, Cascade runs `get_me` to verify your own admin rights before pulling the student profile. It highlights discrepancies instantly. You get clean, structured lists of active memberships without leaving your editor.

Audit LTI setups autonomously with this MCP Server

This toolset uses `list_lti_credentials` and `list_lti_deployments` to inspect external tool integrations across your campuses. Cascade evaluates active connections to find expired keys or broken links. It maps out which external tools are active and where they are deployed. To make sure everything is running right, it cross-references these deployments with `get_activity_logs` to spot connection errors. You get a clear diagnostic report on your LTI tools without opening a browser.

Setup guide

Set up Illumidesk 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 Illumidesk 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 Illumidesk payment history." If connected, Cascade will call the Illumidesk tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "illumidesk-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 Illumidesk. 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 Illumidesk 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 Illumidesk MCP in Windsurf

Open your Windsurf settings and add the server to your `mcp_config.json` file. You can also use the built-in marketplace for a one-click install. Cascade detects the tools instantly on startup.

Yes. Cascade handles multi-step tasks by running `list_campuses` first, selecting the target ID, and then pulling course details with `get_course` automatically. You only provide the high-level goal.

The client paces requests when fetching data via `get_activity_logs`. If you hit a limit, the agent waits and retries the call. This prevents your admin token from getting temporarily blocked.

No. Windsurf auto-discovers all 10 tools upon connection. Once you add the server config, your agent knows exactly how to call each endpoint.

All communication runs through Vinkius's secure, isolated sandbox environment. Your LTI keys and user tokens are never stored or exposed to third parties. They are used only to execute the requested API calls.

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