How to Use the LangGraph Cloud (Stateful AI Agents) MCP in Windsurf

Q: How does Windsurf use LangGraph Cloud (Stateful AI Agents) to manage long-running tasks?

Windsurf's Cascade agent uses createrun to start a task and getrun to poll for its status. This lets it execute jobs that take minutes, not seconds, and report back when finished. You can give it a goal, and it will manage the entire stateful process for you.

Q: Can I manually fix an agent's mistake with this MCP Server?

Yes. If an agent has bad information, use getthreadstate to see its current memory. Then you can use updatethreadstate to correct it. It's a direct way to guide your agent without derailing its entire task.

Let Windsurf's Cascade agent build, monitor, and manage stateful agent workflows in LangGraph Cloud for you.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect LangGraph Cloud (Stateful AI Agents) MCP to Windsurf

Create your Vinkius account to connect LangGraph Cloud (Stateful AI Agents) 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 LangGraph Cloud (Stateful AI Agents) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full Control Over Agent State

This MCP Server gives your agent direct control over its own memory and state. Use `create_thread` to spin up a new, stateful conversation. Cascade can then track its own work, building context over multiple steps. If an agent gets stuck or you need to intervene, `update_thread_state` is your override. You can manually inject new data or correct the agent's path without starting over. It’s like having a direct line into the agent's working memory.

Orchestrate Complex Runs for Windsurf

Kick off multi-step jobs with a single prompt and let Cascade figure out the details. It will use `create_run` to start the process on a specific thread. You can watch the execution in real-time with `get_run` and `list_runs` to see every decision the agent makes. And if a run goes off the rails or starts burning through your budget, you're not helpless. The `cancel_run` tool lets you stop it cold. This gives Cascade the power to manage its own long-running tasks safely.

See Your Entire Agent Operation

Get a high-level view of your whole LangGraph setup from inside your IDE. The `list_assistants` tool shows every agent configuration you have deployed, so Cascade knows what capabilities are available. You don't have to hardcode IDs. Use `list_threads` to see all active conversations your agents are handling. For any automated jobs, `list_crons` shows you exactly what's scheduled to run. No more guessing what your autonomous agents are up to.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "langgraph-cloud-stateful-ai-agents-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 LangGraph Cloud. 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 LangGraph Cloud (Stateful AI Agents) 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 LangGraph Cloud (Stateful AI Agents) MCP in Windsurf

Windsurf's Cascade agent uses `create_run` to start a task and `get_run` to poll for its status. This lets it execute jobs that take minutes, not seconds, and report back when finished. You can give it a goal, and it will manage the entire stateful process for you.

Yes. If an agent has bad information, use `get_thread_state` to see its current memory. Then you can use `update_thread_state` to correct it. It's a direct way to guide your agent without derailing its entire task.

The easiest way is through Windsurf's built-in MCP Marketplace. Just find the server and click to install. Alternatively, you can add it manually in your `mcp_config.json` file.

Just ask Cascade to show you the available agents. It will use the `list_assistants` tool to get a complete list of all your deployed LangGraph configurations, so you can pick the right one for a job.

This server only handles data related to your LangGraph instance, like thread states, run details, and assistant configurations. Your connection from Windsurf is TLS-encrypted, and Vinkius processes each request in a separate, sandboxed container that is destroyed immediately after.

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