How to Use the Cradl AI MCP in Windsurf

Q: How do I configure the Cradl AI MCP integration inside Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file to add the server endpoint. You can also use the Settings menu to open the Cascade MCP Servers UI and click Refresh.

Connect the Cradl AI MCP Server to Windsurf and let Cascade autonomously parse documents, extract data, and pipe it straight into your code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cradl AI MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trigger Document Extractions via Windsurf

The `extract_data_from_url` tool tells Cascade to grab a document from a web address and run it through Cradl AI's OCR engine. You just paste a link to an invoice or receipt in the chat, and the agent handles the prediction request automatically. Once the job kicks off, Windsurf doesn't need to stop and ask for your input. It calls `get_task_status` in the background to check the confidence scores and pull the extracted key-value pairs as soon as they finish processing.

Navigate Your Cradl AI MCP Server Models

Finding the right extraction schema is simple when Cascade uses `list_extraction_models` to read your available model names and training statuses. If you have hundreds of models, the agent can run `search_models_by_name` to pinpoint the exact one meant for tax forms or shipping labels. You get immediate access to the underlying metadata through the `get_model_details` tool. Windsurf reads those schema definitions so it knows exactly what fields to expect before it even tries to parse a file.

Monitor Batch Processing Autonomously

Large document runs require oversight, which the agent handles using `list_batches` to pull identifiers and total document counts. Cascade maps out the entire queue of pending files without you writing a single API call. When a specific run stalls, Windsurf pulls the `get_batch_details` and `list_processing_tasks` tools. It checks the timestamps and failure states, letting you know exactly which files need attention.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "cradl-ai-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 Cradl AI. 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 Cradl AI 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 Cradl AI MCP in Windsurf

Edit your `~/.codeium/windsurf/mcp_config.json` file to add the server endpoint. You can also use the Settings menu to open the Cascade MCP Servers UI and click Refresh.

Yes, Cascade handles bulk operations easily. It triggers the extractions and then polls the batch status until every document finishes parsing.

The agent catches the error immediately. It checks the task status and reports the exact failure reason back in the IDE chat so you can fix the file.

Just ask Cascade to search your account. It runs the built-in search tool to find models by name and pulls down the required schema definitions.

Your file URLs and extracted key-value pairs stay between your machine and the Vinkius endpoint. The agent only reads the OCR results in memory to complete your coding tasks.

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