How to Use the Sansan MCP in Windsurf

Connect Windsurf to your company's network in Sansan and let Cascade turn business cards into actionable contacts automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Sansan MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Find any contact, instantly.

This MCP Server lets you find contacts in your Sansan database. Give Cascade a name, and it will run `search_biz_cards` to find the entry, then pull full details with `get_biz_card` and `get_person`. No more copy-pasting IDs between prompts. Cascade does the whole sequence in one shot. You get the final contact details without having to guide each step. It's the difference between asking for a phone number and just having it appear in your context.

Map your company's network.

Explore your organization's structure without leaving your editor. Ask Cascade to 'show me the marketing team at Acme Corp'. It can use `list_departments` to find the right group, then cross-reference with `list_persons` to pull all the contacts associated with it. This isn't just a list of names. Because Cascade chains the calls, you get a full picture of who works where and what their roles are, all from a single request. It's like having an internal directory that's always up to date.

Let Windsurf organize your contacts.

This toolset is for organizing your network without the manual labor. Tell Cascade to 'tag all contacts from the last trade show'. It will use `list_tags` to see existing categories, find the right cards with `list_biz_cards`, and apply the tags for you. Your agent can now manage your contact database. You set the goal, and this MCP connection handles the tedious work of finding, tagging, and organizing the data in Sansan.

Setup guide

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

mcp_config.json

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

Just ask Cascade in plain English. For example, 'Find John Smith from Acme Inc in Sansan'. Cascade will use the `search_biz_cards` and `get_person` tools to locate the contact and show you the details.

Yes. If you've tagged your cards, you can ask Cascade something like, 'Show me all contacts tagged with Q4-Conference in Sansan'. It will use `list_tags` and `list_biz_cards` to get you the list.

Speed and autonomy. Instead of you running multiple commands, you give Windsurf's Cascade a single goal. It figures out the steps—like searching, getting details, and then listing team members—and executes them in sequence.

Yes. This server connects to your current Sansan account. After you connect it in Windsurf, it will have access to the cards, contacts, and tags you already have.

No, Windsurf doesn't see your data directly. Your AI client sends a request to the MCP server, which runs in a secure Vinkius sandbox. The server performs the action on your behalf and returns only the result, like contact details from `get_person`. Your private contact information never leaves the Sansan environment.

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