# Keyplay MCP

Connect Claude to Keyplay's B2B account intelligence platform. Search, filter, and analyze millions of company profiles — find your ideal customers, build target account lists, and get enriched company data without leaving the conversation.

**Requirements:** A Keyplay account. [Sign up at keyplay.io](https://app.keyplay.io/)

---

## Features

- **Company Search** — Look up any company by name, domain, or LinkedIn URL

- **Account Enrichment** — Get detailed company data: employee count, location, funding, technology stack, hiring signals, and AI-enriched custom fields

- **List Building** — Filter millions of accounts by industry, size, location, signals, and more to build targeted prospect lists

- **Net-New Discovery** — Exclude accounts already in your CRM to find only new prospects

---

## Setup

### Claude.ai / Claude Desktop

1. Open the Connectors Directory in Claude

2. Search for "Keyplay" and click **Connect**

3. Sign in with your Keyplay account when prompted

4. Start using Keyplay tools in any conversation

### Claude Code

**Step 1: Add the server**

```
claude mcp add keyplay --transport http https://api.keyplay.io/mcp \
  --client-id jhXwA4liDuG7rAKr999E9mle8buzsxJ1 \
  --callback-port 3334
```

**Step 2: Authenticate**

Start Claude Code and run `/mcp`. Select Keyplay and follow the browser login flow to sign in with your Keyplay credentials.

If you belong to multiple Keyplay workspaces, use the whoami tool to see your memberships and switch_customer to select the right one.

**Step 3: Verify the connection**

```
claude mcp list
```

---

## Usage Examples

### Example 1: Look Up a Company

**Prompt:** "Look up Stripe on Keyplay and tell me about their employee count, location, and what signals they match."

**What happens:** Searches for "Stripe" by name, retrieves employee count, HQ location, and matching signals across organization, profile, relevance, and tech stack categories. Returns a summary of the company's key attributes.

### Example 2: Build a Target Account List

**Prompt:** "Find B2B SaaS companies in the US with 100 to 500 employees that are currently hiring. Show me the top 10 with their locations."

**What happens:** Discovers valid signal and category IDs available for filtering. Filters accounts by audience, industry, country, employee range, and hiring signal. Returns a ranked list of matching companies with names, domains, and HQ locations. Includes facet counts showing the distribution by category, audience, and country.

### Example 3: Discover Net-New Prospects

**Prompt:** "Find fintech companies in Europe with over 200 employees that we're not already tracking."

**What happens:** Filters accounts by industry, country, and employee count. Excludes accounts already in your CRM using the net-new filter. Returns only companies you haven't seen before, with names, domains, and employee counts.

### Example 4: Research a Company's Tech Stack

**Prompt:** "Look up Linear on Keyplay. What technology signals do they match? Also show me their enriched fields."

**What happens:** Searches for Linear by name. Retrieves technology stack signals and AI-enriched custom fields. Returns details about the company's tech profile and any custom enrichment data configured in your Keyplay account.

### Example 5: Explore What You Can Filter By

**Prompt:** "What technology stack signals can I filter by in Keyplay?"

**What happens:** Returns all available tech stack signals with their names (e.g., Salesforce, HubSpot, Stripe, AWS). You can then use these signals to build targeted filter queries.

---

## Tools

The Keyplay MCP server exposes four tools.

### search_accounts — Search Accounts

Look up a specific company by name, domain, or LinkedIn URL. Returns matching accounts with IDs you can use for enrichment.

**Parameters:**

| Parameter | Required | Description                                                               |
| --------- | -------- | ------------------------------------------------------------------------- |
| `query`   | Yes      | The search term (e.g., "Stripe", "stripe.com", or a LinkedIn company URL) |
| `type`    | No       | One of `name`, `domain`, or `linkedin`. Defaults to name.                 |

**Example:**

```
{ "query": "stripe.com", "type": "domain" }
```

### get_account_data — Get Account Data

Get detailed enrichment data for a specific account by ID.

**Parameters:**

| Parameter | Required | Description                                                |
| --------- | -------- | ---------------------------------------------------------- |
| `id`      | Yes      | The account ID (from search\_accounts or filter\_accounts) |
| `include` | No       | Array of data sections to return (see below)               |

By default, returns only id, name, domain, and tracked status. Use `include` to request additional sections:

| Include value | What it returns                                                   |
| ------------- | ----------------------------------------------------------------- |
| `linkedIn`    | LinkedIn URL                                                      |
| `categories`  | Audience (B2B/B2C), primary and secondary categories              |
| `location`    | HQ country and state                                              |
| `employees`   | Employee count                                                    |
| `signals`     | Org, profile, relevance, and stack fit signals                    |
| `fields`      | Core account fields, AI-enriched custom fields, and intent fields |
| `summary`     | 10-word business description                                      |
| `scoring`     | ICP tier, fit scores, and intent scores (tracked accounts only)   |

**Example:**

```
{ "id": "62b135af1de7b1246567f164", "include": ["employees", "location", "signals", "summary"] }
```

### filter_accounts — Filter Accounts

Filter and browse millions of accounts using criteria. Use this for building lists.

**Simple filter parameters:**

| Parameter                           | Description                                                                |
| ----------------------------------- | -------------------------------------------------------------------------- |
| `audience`                          | `["b2b"]`, `["b2c"]`, or both                                              |
| `primaryCategory`                   | Business category IDs (use list\_filter\_options to discover valid values) |
| `secondaryCategory`                 | Secondary category IDs                                                     |
| `signals`                           | Signal IDs (use list\_filter\_options to discover valid values)            |
| `hqCountry`                         | Country codes, e.g. `["US", "GB"]`                                         |
| `hqState`                           | State codes, e.g. `["US-CA", "US-NY"]`                                     |
| `employeesMin` / `employeesMax`     | Employee count range                                                       |
| `fundingMin` / `fundingMax`         | Funding amount range in dollars                                            |
| `trafficRankMin` / `trafficRankMax` | Web traffic rank range (lower = more traffic)                              |

**Options:**

| Parameter        | Description                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------- |
| `advancedFilter` | Complex nested AND/OR logic. Cannot be combined with simple filters.                        |
| `sortBy`         | `discoverScore` (default), `employees`, `funding`, `yearFounded`, or `trafficRank`          |
| `sortOrder`      | `desc` (default) or `asc`                                                                   |
| `limit`          | Results per page, 1–100 (default 25)                                                        |
| `cursor`         | Pagination cursor from previous response                                                    |
| `includeTotal`   | Include total count (slower)                                                                |
| `excludeTracked` | Only return accounts not already in your CRM                                                |
| `include`        | Additional fields per account: `linkedIn`, `categories`, `location`, `employees`, `summary` |

Filters within the same field are OR'd. Filters across different fields are AND'd. The first page includes facet counts showing distribution by category, audience, country, and signals.

**Example:**

```
{   "audience": ["b2b"],   "primaryCategory": ["saasAndCloud"],   "hqCountry": ["US"],   "employeesMin": 100,   "employeesMax": 500,   "signals": ["hiring"],   "include": ["employees", "location", "summary"] }
```

### list_filter_options — List Filter Options

Discover valid IDs for use with filter_accounts. Call this before filtering to see what signals, categories, and other options are available.

**Parameters:**

| Parameter        | Required                | Description                                                          |
| ---------------- | ----------------------- | -------------------------------------------------------------------- |
| `field`          | Yes                     | One of `signals`, `audience`, `primaryCategory`, `secondaryCategory` |
| `signalCategory` | When field is `signals` | One of `profile`, `org`, `relevance`, `stackFit`                     |

**Signal categories:**

| Category    | What it covers                                                        |
| ----------- | --------------------------------------------------------------------- |
| `profile`   | Company profile signals: founded date, employee ranges, funding, etc. |
| `org`       | Organization signals: hiring, team composition, headcount growth      |
| `relevance` | Website features, compliance certifications, traffic, messaging       |
| `stackFit`  | Technology stack: tools, platforms, integrations (400+ technologies)  |

Returns `{id, label}` pairs. Use the `id` value in your filters, not the label.

**Example:**

```
{ "field": "signals", "signalCategory": "org" }
```

### whoami — Who Am I

Get current MCP authentication and customer context.

**Parameters**: None

Use this when:

- You need to confirm which workspace MCP is scoped to

- A tool returns `customer_context_ambiguous` and you need available customer IDs

- You want to verify whether context came from token claim, override, or fallback

Response includes:

- authMode: `oauth` or `api_key`

- activeCustomer: current customer (or null if ambiguous)

- memberships: available workspaces for OAuth/SSO users

- selectionSource: how context was resolved (`mcp_override`, `token_claim`, `single_membership_fallback`, or `none`)

- contextState: `resolved` or `ambiguous`

### switch_customer

Set the active workspace for the current OAuth/SSO session.

**Parameters**:

| Parameter    | Description                                |
| ------------ | ------------------------------------------ |
| `customerId` | Target customer ID from whoami memberships |

Use this when:

- You have multiple workspace memberships

- Context is ambiguous and a tool asks you to choose a workspace

- You want to change MCP scope without changing your app login state

Notes:

- OAuth/SSO only (not supported for API key auth)

- Does not modify app workspace switcher state

- Persists across conversations until changed

---

## Prompts

The Keyplay MCP server includes five guided workflows. In Claude, these appear as slash commands you can invoke to start a structured, multi-step GTM workflow.

### analyze_customers — Analyze Customers

Analyze your customer list to find patterns for ICP definition. Upload a customer CSV and provide your company domain. Keyplay enriches each customer and identifies what your best accounts have in common across signals, size, geography, and technology.

| Argument         | Required | Description                                    |
| ---------------- | -------- | ---------------------------------------------- |
| `company_domain` | Yes      | Your company's website domain (e.g., acme.com) |

### define_icp — Define ICP

Create a full ICP Targeting Strategy document with SAM definition, ICP themes, segments, and a scoring framework. Upload a customer CSV and provide your company domain. Produces an executive-level strategy document.

| Argument         | Required | Description                   |
| ---------------- | -------- | ----------------------------- |
| `company_domain` | Yes      | Your company's website domain |

### concept_campaign — Concept Campaign

Develop targeted campaign angles from your ICP definition. Finds specific opportunities driven by case studies, business situations, and timing signals. Returns 3–4 campaign concepts with estimated reach.

| Argument         | Required | Description                                     |
| ---------------- | -------- | ----------------------------------------------- |
| `company_domain` | Yes      | Your company's website domain                   |
| `direction`      | No       | Specific direction, segment, or idea to explore |

### build_target_list — Build Target List

Build a tiered target account list using Keyplay filters. Generates multiple output files: a full enriched list, LinkedIn Ads CSV, sales brief, and prospecting CSV with personalization hooks.

| Argument             | Required | Description                                                                             |
| -------------------- | -------- | --------------------------------------------------------------------------------------- |
| `targeting_criteria` | Yes      | Who to target: industries, employee range, geography, key signals, and any ICP criteria |

### write_account_brief — Write Account Brief

Generate a detailed Account Fit Brief for a target account. Assesses ICP fit, identifies outreach angles, flags risks, and highlights research gaps. Supports single accounts or batch mode.

| Argument         | Required | Description                                                                     |
| ---------------- | -------- | ------------------------------------------------------------------------------- |
| `target_account` | Yes      | Company name or domain, or "batch" for multiple accounts                        |
| `icp_context`    | Yes      | Brief description of your ICP: key themes, segments, what makes a good customer |

---

## Troubleshooting

### Authentication

**"Connection failed" or "Unauthorized" errors** Make sure you're signed into your Keyplay account. The MCP connector uses OAuth, so you'll be prompted to log in when you first connect. Try disconnecting and reconnecting the Keyplay connector in your Claude settings. If using Claude Code with an API key, verify the key is still valid in your Keyplay account settings.

**"Session expired" errors** Reconnect the Keyplay connector. OAuth sessions may expire after extended periods of inactivity.

### Filtering

**"Cannot combine simple filters with advancedFilter"** You're mixing simple filter parameters (like `audience`, `primaryCategory`) with the `advancedFilter` parameter. Use one approach or the other, not both. If you need complex AND/OR logic, put everything inside `advancedFilter`.

**No results returned** Your filters may be too narrow. Try removing one filter at a time to see which one is excluding all results. Check that you're using valid signal and category IDs by calling `list_filter_options` first. Employee count and funding ranges that are too tight can also eliminate most accounts.

**"excludeTracked" returning an error** The net-new filter only works when your filter criteria match 10,000 or fewer accounts. Narrow your filters to reduce the result set.

### Data

**"Tracked" vs. "Untracked" accounts** Tracked accounts are in your CRM or have been added to your Keyplay pipeline. Untracked accounts exist in Keyplay's database but aren't in your CRM yet. Use `excludeTracked: true` in filter_accounts to find only net-new accounts.

**Scoring data returns null** ICP scoring (tier, fit scores, intent scores) is only available for tracked accounts. If the account isn't tracked, scoring fields will return null.

**Enriched fields are empty** AI-enriched custom fields depend on your Keyplay account configuration. If you haven't set up custom AI agents in Keyplay, these fields will be empty.

### Claude Code Setup

**"Server not found" after running `claude mcp add`** Verify the server URL is exactly `https://api.keyplay.io/mcp`. Check that the Authorization header format is correct: `Bearer YOUR_API_KEY` (with a space after Bearer). Run `claude mcp list` to confirm the server was added.

---

## Privacy Policy

[Keyplay Privacy Policy](https://keyplay.io/legal/privacy/)

## Support

- **Email:** <support@keyplay.io>

- **Website:** [keyplay.io](https://keyplay.io/)