How to Use the Clearstory MCP in Windsurf

Q: Can Windsurf read my Clearstory change order requests?

Yes. Cascade uses the listchangeorderrequests tool to pull pending, approved, and rejected CORs into your workspace. Background API calls happen automatically while you type.

Q: Does the Clearstory integration support contract lookups?

It pulls linked agreements using listprojectcontracts. You can ask your agent to match those contracts against specific change orders.

Track construction change orders and T&M tags via this MCP Server directly inside Windsurf without breaking your coding flow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clearstory MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate change order tracking with this MCP Server

Cascade pulls live construction data straight into your editor workspace. You ask for an update on a specific site, and it fires off `list_construction_projects` to find the correct ID. Then it automatically chains `get_project_construction_details` without stopping to ask for permission. Getting the full financial breakdown happens in the background while you keep writing code.

Audit T&M tags autonomously

Field teams submit material tickets constantly. Your agent hits `list_tm_tags` to pull every digital Time & Material record from the site directly into your local environment. It cross-references those entries against the approved LMEO rates using `list_construction_rates`. Cascade spots billing discrepancies before they ever hit the accounting system.

Monitor contractor notifications

Communication breakdowns kill construction timelines. Windsurf can fetch the exact paper trail by calling `list_change_notifications` to see what contractors actually received. If a dispute arises over a specific request, it digs deeper with `get_cor_details`. You see the exact status of the change order right next to your project management scripts.

Setup guide

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

mcp_config.json

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

Open your MCP panel and click Refresh, or add it to your configuration file. Cascade auto-discovers the tools the second you connect.

Yes. Cascade uses the `list_change_order_requests` tool to pull pending, approved, and rejected CORs into your workspace. Background API calls happen automatically while you type.

It pulls linked agreements using `list_project_contracts`. You can ask your agent to match those contracts against specific change orders.

Context switching wastes time. Having Cascade pull construction rates directly into your IDE means you build reporting scripts much faster.

Vinkius runs this connection through a V8 Isolate Sandbox. Your LMEO rates, CORs, and T&M tags stay completely isolated, and the ephemeral setup means nothing persists after the session ends.

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