Keyplay MCP | Keyplay Help Center

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

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

Open the Connectors Directory in Claude
Search for "Keyplay" and click Connect
Sign in with your Keyplay account when prompted
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

Support

Email: [email protected]
Website: keyplay.io