How to Use the Sansan MCP in Claude Code

Q: How can I use Claude Code to find a specific business card in Sansan?

From your terminal, you'd run a command like claude mcp sansan-mcp searchbizcards --query "John Doe". This executes the search and prints the results as JSON, which you can then pipe to other command-line tools.

Q: How do I see what departments are available to query?

It's a single command. Just run claude mcp sansan-mcp listdepartments in your terminal. It will return a JSON list of all departments configured in your Sansan account.

Pipe your entire Sansan business card database directly into your shell scripts and CI/CD pipelines with Claude Code.

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 Claude Code

Create your Vinkius account to connect Sansan to Claude Code — 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Export and pipe contact data.

These tools let you export contacts as JSON for other programs. Run `claude mcp sansan-mcp list_persons` and pipe the raw JSON output directly to `jq` for filtering or a script for processing. It’s a clean, scriptable way to access your entire contact list. Forget manual exports from a web UI. You can set up a cron job to pull fresh contact data every hour, find new leads with `search_biz_cards`, and feed them into another system. This is your data, on your terms, in your terminal.

Build automated reports from the CLI.

This MCP server enables automated reporting from the command line. A simple shell script can call `list_biz_cards` with a date filter, `list_users` to see who added them, and format a plain text report to be posted to a Slack channel via a webhook. This turns your Sansan account into a programmable data source. You can build monitoring and reporting that fits exactly how your team works, all within your existing CI/CD environment.

Run headless directory sync jobs.

Keep an external system in sync with your Sansan org chart. Write a GitHub Action that runs nightly, calls `list_departments` and `list_persons`, and updates an internal database or LDAP server. The process is completely headless and requires no user interaction. This isn't about looking up one person. It's about treating your entire Sansan network as a database you can query and sync from any automated environment. If a new user is added, your script can see it via `list_users` and provision access elsewhere.

Setup guide

Set up Sansan MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see sansan-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Sansan transactions." It will automatically discover and invoke the available Sansan tools.

Terminal

claude mcp add --transport http sansan-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "sansan-mcp": {
      "type": "url",
      "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 Claude Code

From your terminal, you'd run a command like `claude mcp sansan-mcp search_biz_cards --query "John Doe"`. This executes the search and prints the results as JSON, which you can then pipe to other command-line tools.

Yes. You can install Claude Code in your workflow, add your MCP server credentials as secrets, and then call the Sansan tools directly in your script. For example, you could have a job that runs `list_persons` to check for new contacts.

It makes your Sansan data available for any automated, headless process. You don't need to write custom API clients or manage OAuth tokens in your scripts. Just use the simple `claude mcp` command to access any tool.

It's a single command. Just run `claude mcp sansan-mcp list_departments` in your terminal. It will return a JSON list of all departments configured in your Sansan account.

Your data's security is handled by Vinkius's zero-trust model. Your CI runner only communicates with the MCP server endpoint, not Sansan directly. The server processes requests for things like `get_biz_card` data in an ephemeral, isolated sandbox. The sensitive business card details are never logged or stored on the runner or in the Vinkius platform itself.

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