# Sansan MCP for AI Agents AI Agent Connect

> Sansan MCP lets you pull your company's digitized business card network into your AI client. You can browse contacts, search for specific people, and see how your organization is structured. It turns your physical networking history into a searchable database for your agent to use.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_aTHZ4ixbEPq26LqQ4QeE5qTgjpZ6yYtSiiqnlQKf/ai-agent-connect
- **Tags:** business-card-digitization, contact-management, network-analysis, data-entry, crm-sync

## Description

Imagine you're in a meeting and need to find that one person you met at a conference three years ago. Instead of digging through old folders or scrolling through a messy CRM, you just ask your AI client to find them. This Connector connects your Sansan account directly to your agent, giving it a direct line to your organization's full network of digitized business cards. You can have your agent pull up specific contact details, list out everyone in a certain department, or show you all the tags you use to organize your leads. It's like giving your AI a brain that actually knows who everyone is. When you use this through the Vinkius catalog, you don't have to worry about manual data entry or switching tabs. You just get a searchable relationship graph that works exactly how you need it to.

## Tools

### get_biz_card
Get the full details for a specific business card. Use this to see the exact info on a single card.

### get_person
Pull a specific contact profile. This helps when you need to see a unified view of a person from multiple cards.

### list_biz_cards
See a list of all scanned business cards. Use this to browse your entire card history at once.

### list_departments
List every department in your organization. This shows you how the company is structured.

### list_persons
Get a list of all contact people. Use this to see every unique person in your database.

### list_tags
See all the tags you use for organization. This helps you understand how your network is categorized.

### list_users
See all Sansan users in your company. This shows you who else has access to the system.

### search_biz_cards
Search for cards by name. This lets you quickly find specific people in a large database.

## Prompt Examples

**Prompt:** 
```
Find a business card for someone named Tanaka.
```

**Response:** 
```
I found 2 cards for Tanaka: 

1. **Hiroshi Tanaka** (Director at Widget Corp)
2. **Kenji Tanaka** (Sales Manager at Acme)

Would you like the full details for one of these?
```

**Prompt:** 
```
What tags do I have for my cards?
```

**Response:** 
```
You have the following categories in your Sansan database:

* VIP
* 2025 Tech Summit Leads
* Vendor
* Partner

You can ask me to find contacts associated with any of these.
```

**Prompt:** 
```
Get the profile for person-12345.
```

**Response:** 
```
Here is the profile for **person-12345**:

* **Name**: Satoshi Nakamoto
* **Title**: CEO
* **Email**: satoshi@example.com
* **Phone**: +81 3-1234-5678

Note: This profile was created by merging 3 different business cards.
```

## Capabilities

### Search for specific business cards by name
Find any card in your database instantly by asking your agent for a person's name.

### Pull up full contact details
Get the phone numbers, emails, and titles from a specific card without opening the app.

### List every contact person
See a complete list of all unique people across your entire scanned card history.

### View company departments
See how your organization is structured by listing all registered departments.

### Get a list of all organization tags
See every category you use to organize your professional network.

### See registered Sansan users
Check which users in your organization have access to the Sansan system.

### Retrieve unified person profiles
Get a single profile for a person even if they have multiple cards in the system.

## Use Cases

### Pre-call research for sales
A rep asks the agent to find the contact info for a lead from a specific conference. The agent uses search_biz_cards to find the card and get_biz_card to show the phone number.

### Executive networking history
An executive needs to remember a specific person from a 2023 summit. They ask the agent to find the person's details, and the agent pulls the record using get_person.

### Operations audit
An admin needs to see how many people are in the marketing department. They ask the agent to list_departments and list_persons to get a head count.

### Tag management
A user wants to see how they've been organizing their cards. They ask the agent to list_tags to see all the categories they've created.

## Benefits

- Stop hunting for contact info by having your agent pull up specific card details using get_biz_card.
- See your entire company structure instantly with list_departments to understand who's who.
- Find specific people from past events quickly using search_biz_cards without opening a browser.
- Get a unified view of a contact across multiple cards with get_person to avoid duplicate info.
- Organize your leads better by viewing all active tags with list_tags to see how you categorize your network.
- Audit your internal team access and structure easily with list_users and list_departments.

## How It Works

The bottom line is your AI gets instant access to your company's entire network of physical and digital contacts.

1. Subscribe to the Sansan MCP on Vinkius.
2. Add your Sansan API Key to your AI client settings.
3. Ask your agent to find contacts or list company departments.

## Frequently Asked Questions

**What does the Sansan MCP do for my AI agent?**
It gives your AI agent direct access to your company's digitized business card library. Your agent can then find contact info, list departments, and search your network history for you.

**Can I search for specific people in my Sansan account?**
Yes, you can ask your agent to search for anyone by name. It will scan your database and provide the matching cards and contact details instantly.

**How does this help with my business card history?**
It turns your old physical cards into a searchable database. You can ask your agent to pull up details from years of networking without having to open the Sansan app.

**Can the AI see my company's departments?**
Yes, the Connector allows your agent to list all departments in your organization, making it easy to see how your company is structured.

**Will this help me find contacts from past events?**
Absolutely. If you have scanned cards from past summits or conferences, your agent can find those specific people and their current titles for you.

**How do I get my contact tags into my AI client?**
Once you connect the Connector, your agent can see all your organization tags. You can then ask it to find leads or contacts associated with specific categories like 'VIP' or 'Vendor'.

**Can I see who else in my company uses Sansan?**
Yes, the Connector can list all registered Sansan users in your organization, which is helpful for internal audits or checking who has access to the network.

**Can my AI agent find a specific business card by just a first name?**
Yes. Ask the agent to run the `search_biz_cards` tool with the contact's name. It will look through all digitized cards in the shared corporate database and return the matching profiles, including their company, department, and direct contact details.

**Is it possible to list only contacts from a specific department?**
Yes, you can ask your agent to first execute `list_departments` to view your organizational structure, and then cross-reference those entities with the cards via natural prompts to summarize card acquisitions per department.

**What is the difference between business cards and persons?**
Business Cards are individual scan snapshots of physical cards acquired over time. A 'Person' represents the consolidated identity created when multiple updated cards from the same individual are merged. You can query both views via `list_biz_cards` or `list_persons`.