How to Use the OpnForm MCP in Windsurf

Q: How do I connect OpnForm to Windsurf?

Open your mcpconfig.json file in Windsurf and add the server configuration under the mcpServers key. Once you hit refresh, Cascade instantly registers all eleven tools on this MCP Server for managing your forms and submissions.

Q: Can Windsurf delete submissions in OpnForm?

Yes. Cascade uses the deletesubmission tool to remove specific entries from your records. You just tell the agent which submission ID to target, and it handles the API call.

Q: How does Windsurf handle multiple OpnForm workspaces?

The agent uses listworkspaces to see everything you have access to. From there, it can target a specific workspace ID when running listforms or creating new assets.

Q: What happens if a form creation fails?

The createform tool returns the exact error from the API. Windsurf reads this payload, fixes the formatting or missing parameters, and retries the creation automatically.

Create, update, and track open-source forms directly inside Windsurf using Cascade's autonomous multi-step agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect OpnForm MCP to Windsurf

Create your Vinkius account to connect OpnForm to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup OpnForm with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Build forms instantly inside your workspace

The `create_form` tool on this MCP Server lets your AI client spin up new forms without leaving your editor. You tell Cascade what fields you need, and it handles the API calls to set up the configuration, fields, and options in one go. If you need to make changes, `update_form` modifies existing setups on the fly. Cascade can chain these actions together, meaning it writes your frontend code and configures the backend form to match in a single session.

Fetch and monitor submissions autonomously

The `list_submissions` tool pulls responses directly into your workspace so Cascade can analyze them. You don't have to export CSV files or log into an external dashboard to see what your users are submitting. When you need to inspect a specific entry, `get_submission` retrieves the exact payload. Your agent can scan these submissions, flag issues, or even write scripts to process the incoming data automatically.

Manage workspaces through this MCP Server

The `list_workspaces` tool exposes your entire organizational structure to the agent. It maps out your active environments so you always deploy forms to the correct team space. Using `get_workspace` and `get_me`, the agent verifies your permissions before executing destructive actions like `delete_form`. This safety check prevents accidental deletions of live production forms.

Setup guide

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

mcp_config.json

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

Open your `mcp_config.json` file in Windsurf and add the server configuration under the `mcpServers` key. Once you hit refresh, Cascade instantly registers all eleven tools on this MCP Server for managing your forms and submissions.

Yes. Cascade uses the `delete_submission` tool to remove specific entries from your records. You just tell the agent which submission ID to target, and it handles the API call.

The agent uses `list_workspaces` to see everything you have access to. From there, it can target a specific workspace ID when running `list_forms` or creating new assets.

The `create_form` tool returns the exact error from the API. Windsurf reads this payload, fixes the formatting or missing parameters, and retries the creation automatically.

This integration handles form submissions and workspace metadata using Vinkius's secure MCP sandbox. Your API keys and raw submission payloads never touch external logs, keeping your users' private form inputs completely isolated.

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