How to Use the Common Paper MCP in Windsurf

Q: How does Windsurf use Common Paper to automate contract creation?

Cascade chains tools together, first running listtemplates to find the right Common Paper contract, then executing sendagreement with your recipient's details. It handles the entire multi-step process inside Windsurf without requiring you to write API glue code.

Q: Can I search signed agreements inside Windsurf?

Yes, Cascade can run searchagreementsbyemail or listsignedagreements directly from your Windsurf chat panel. It parses the returned JSON list and displays the status of active Common Paper negotiations right in your editor.

Q: What happens if a Common Paper template ID changes in Windsurf?

Cascade runs listtemplates through the MCP integration to fetch the updated list of available contracts from your Common Paper account. It then updates your Windsurf configuration files with the new template ID so your automated sends don't break.

Windsurf's Cascade autonomously drafts, sends, and tracks your Common Paper sales contracts without you clicking around.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Common Paper MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-send agreements directly from Windsurf chat

The `send_agreement` tool lets Cascade pull a template ID, populate the recipient's details, and dispatch a Common Paper contract without manual copy-pasting. Cascade reads your local Windsurf project context to find the client's email, matches it to your files, and kicks off the signing process instantly. You can instruct Cascade to run `list_templates` first to verify the correct Common Paper contract structure before sending. Cascade handles the API handshake behind the scenes using this MCP Server so your Windsurf development workflow remains uninterrupted.

Track contract status inside this Windsurf MCP Server

The `list_signed_agreements` tool lets Cascade check who has signed, then updates your local Windsurf workspace files or database schemas to match. Instead of checking your inbox or logging into a browser, you ask Cascade to verify the Common Paper signature state directly in your IDE. If you need to inspect a specific contract, Cascade invokes `get_agreement` to pull down the exact Common Paper terms and metadata. This integration keeps your legal pipeline visible right alongside your Windsurf codebase.

Automate webhook configuration during Windsurf testing

The `create_webhook` tool lets Cascade configure your local Windsurf development endpoints with this MCP Server to receive instant updates when a client signs a Common Paper contract. Cascade writes the receiver code in your editor, deploys it, and registers the URL with Common Paper in one single chain of actions. When you tear down your local Windsurf environment, Cascade cleans up by calling `delete_webhook` to prevent dead Common Paper requests. You don't have to jump into a dashboard to manage these endpoints manually anymore.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "common-paper-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 Common Paper. 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 Common Paper 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 Common Paper MCP in Windsurf

Cascade chains tools together, first running `list_templates` to find the right Common Paper contract, then executing `send_agreement` with your recipient's details. It handles the entire multi-step process inside Windsurf without requiring you to write API glue code.

Yes, Cascade can run `search_agreements_by_email` or `list_signed_agreements` directly from your Windsurf chat panel. It parses the returned JSON list and displays the status of active Common Paper negotiations right in your editor.

You tell Cascade to build a listener, and this MCP Server uses `create_webhook` to register your endpoint with Common Paper. Cascade handles both the local Windsurf code generation and the external API execution.

Cascade runs `list_templates` through the MCP integration to fetch the updated list of available contracts from your Common Paper account. It then updates your Windsurf configuration files with the new template ID so your automated sends don't break.

Your Common Paper contract metadata, signatures, and agreement details are processed in an isolated Vinkius sandbox before reaching the API. Windsurf never stores your legal documents locally or uses them to train models.

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