<p align="center">
  <img src="xverum.png" alt="Xverum" width="900">
</p>

# Xverum — MCP Server

<p align="center">
  <a href="https://cursor.com/en/install-mcp?name=xverum&config=eyJ1cmwiOiJodHRwczovL21jcC54dmVydW0uY29tL21jcCJ9"><img src="https://custom-icon-badges.demolab.com/badge/Install_in_Cursor-000000?style=for-the-badge&logo=cursor-ai-white" alt="Install in Cursor" /></a>
  <a href="https://vscode.dev/redirect/mcp/install?name=xverum&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.xverum.com/mcp%22%7D"><img src="https://custom-icon-badges.demolab.com/badge/Install_in_VS_Code-007ACC?style=for-the-badge&logo=vsc&logoColor=white" alt="Install in VS Code" /></a>
</p>

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blueviolet)
![Claude Ready](https://img.shields.io/badge/Claude-Ready-orange)
![OpenAI Compatible](https://img.shields.io/badge/OpenAI-Compatible-lightgrey)
![GDPR Compliant](https://img.shields.io/badge/GDPR-Compliant-green)
![CCPA Compliant](https://img.shields.io/badge/CCPA-Compliant-green)

Find and enrich the right people and companies from 750M professional profiles and 54M company profiles. Search in plain English: people by role, seniority, skills, industry, and location, and companies by industry, size, and location. Pull full profiles for people and companies. For people, get 200M+ verified business emails and phone numbers, and see who’s likely to change jobs next with Next Move Signal. Built for AI agents and products: sourcing candidates, building lead lists, and researching markets and accounts.


This is a **hosted, remote MCP server** — there is nothing to install or run. Point your
client at the endpoint below and sign in with OAuth.

## Is there an MCP server for finding people?

Yes. The Xverum MCP lets your AI assistant find and enrich the right people
from a global professional-profiles dataset — no scraping, no browser tabs. Ask in plain
language (*"find senior data engineers in Amsterdam"* or *"VPs of sales at Series A SaaS
companies"*) and it returns ranked profiles; ask about one and it pulls the full
background. It's built for two jobs: sourcing job candidates by role, skills, and
location, and building sales lead lists of decision-makers. Connect it to Claude or any
MCP-compatible assistant in one command.

## Prerequisites

Sign up at [Ask Xverum](https://ask.xverum.com/).

## Connect your client

```bash
claude mcp add --transport http xverum https://mcp.xverum.com/mcp
```

<details>
<summary><b>Claude Code — verify</b></summary>

Verify with `/mcp` — you should see `xverum` with nine tools.

</details>

<details>
<summary><b>Cursor</b></summary>

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "xverum": {
      "type": "http",
      "url": "https://mcp.xverum.com/mcp"
    }
  }
}
```

</details>

<details>
<summary><b>Visual Studio Code</b></summary>

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "xverum": {
      "type": "http",
      "url": "https://mcp.xverum.com/mcp"
    }
  }
}
```

</details>

<details>
<summary><b>Any other MCP client</b></summary>

Most clients take a JSON config of this shape:

```json
{
  "mcpServers": {
    "xverum": {
      "type": "http",
      "url": "https://mcp.xverum.com/mcp"
    }
  }
}
```

Consult your client's docs for where that file lives.

</details>

Also in the MCP Registry as `com.xverum/mcp`, so many agents can add it by name.

> **Authentication.** The server uses OAuth — on first connection your client opens a
> browser window to sign in. No API keys to paste. See [docs/authentication.md](docs/authentication.md).

## Tools

| Tool | What it does | Cost |
|------|--------------|------|
| `search_people_xverum` | Find people matching a natural-language description  – candidates, prospects, or decision-makers. Returns ranked profiles. | 1 credit per result |
| `enrich_person_xverum` | Pull the full profile for one person by id: description, work history, education, and seniority. | 4 credits per full profile |
| `predict_job_change_xverum` | Score how likely a person is to change roles  – before they declare it. Refreshed weekly. | 10 credits per score |
| `search_company_xverum` | Find companies from a natural-language description. Returns a ranked page of company summary cards. | 1 credit per result |
| `enrich_company_xverum` | Pull the full record for one company. | 4 credits per full company |
| `get_email_xverum` | Get the verified business email for one person. Charged only when found. | 2 credits per person |
| `get_phone_xverum` | Get the verified phone number for one person. Charged only when found. | 6 credits per person |
| `find_person_by_email_xverum` | Find the person behind a work email address. Returns a profile summary with id. | 1 credit per match |
| `find_person_by_phone_xverum` | Find the person behind a phone number. Returns a profile summary with id. | 1 credit per match |

Full reference: [docs/tools.md](docs/tools.md).

### Examples

**Example 1: Search people** (`search_people_xverum`)
```
Senior Python developers with Kubernetes in Seattle
```

**Example 2: Enrich a profile** (`enrich_person_xverum`)
```
Get profile id 401241903
```

**Example 3: Predict job changes** (`predict_job_change_xverum`)
```
Use predict_job_change_xverum for profile ID 271961733.
```

**Example 4: Search companies** (`search_company_xverum`)
```
cybersecurity companies in Germany
```
```
nonprofit organizations working on climate change in California
```

**Example 5: Enrich a company** (`enrich_company_xverum`)
```
Get company id 88673718
```

**Example 6: Get email** (`get_email_xverum`)
```
Get the email for profile id 482910371
```

**Example 7: Get phone** (`get_phone_xverum`)
```
Get the phone number of prospect 482910371 before a call
```

**Example 8: Find person by email** (`find_person_by_email_xverum`)
```
Who is jane.doe@example.com?
```

**Example 9: Find person by phone** (`find_person_by_phone_xverum`)
```
Who is +12025550123
```


## Credits

1 credit per search result · 4 credits per full profile · 10 credits per job-change score · 1 credit per company search result · 4 credits per full company · 2 credits per email (only when found) · 6 credits per phone (only when found) · 1 credit per email-lookup match · 1 credit per phone-lookup match.
Each response reports `credits_used` and `credits_remaining`.
[See plans and pricing](https://ask.xverum.com/pricing)


## Docs

- [Quickstart](docs/quickstart.md) — connect and run your first search.
- [Tools](docs/tools.md) — parameters, return shapes, and worked examples.
- [Authentication](docs/authentication.md) — OAuth sign-in and what we store.
- [Troubleshooting](docs/troubleshooting.md) — error codes and what to do about them.
- [Versioning](docs/versioning.md) — versioning scheme and deprecation policy.

## Privacy & security

- Authentication is handled via OAuth — no API keys are stored or transmitted in config files.
- The server exposes exactly the nine tools listed above. It cannot write, delete, or take
  any action on your behalf.
- Profile data comes from Xverum's licensed professional-profiles dataset.

## Links

- [Ask Xverum](https://ask.xverum.com/docs/mcp-server/) — website
- [MCP Registry](https://registry.modelcontextprotocol.io) — `com.xverum/mcp`

## Support

Questions or issues: open an issue on this repo, or contact us via
[agentic.support@xverum.com](mailto:agentic.support@xverum.com).

[![smithery badge](https://smithery.ai/badge/xverum/xverum-mcp)](https://smithery.ai/servers/xverum/xverum-mcp)