MCP documentation
MCP Server Tool Reference
Complete reference for all tools exposed by the GetContacts MCP server. Use these tools from any MCP-compatible AI agent to look up companies, contacts and build filtered target groups.
Quick start
- Create an account. Register here
- Activate your subscription from the account page, then create an MCP access token. Go to account
- Paste the URL into VS Code or Claude and finish the browser sign-in when prompted. OAuth creates the token automatically.
Configuration
For VS Code and Claude, add the MCP URL below. They handle OAuth sign-in and token creation automatically.
VS Code and Claude
Use the hosted MCP URL directly. No manual JSON or token setup is needed in these clients.
MCP endpoint
https://app.getcontacts.example/mcp
- Add a new MCP server in VS Code or Claude.
- Paste the GetContacts MCP URL.
- Complete the browser sign-in flow when prompted.
Other MCP clients
If your MCP client does not support MCP OAuth yet, open token management to create a token and copy the ready-made JSON configuration with the actual token value.
The server uses HTTP Streamable transport. OAuth is preferred when the client supports it; otherwise authenticate with a Bearer token in the Authorization header.
Authentication
VS Code and Claude use OAuth automatically when you add the MCP URL. Clients without OAuth support must send an Authorization: Bearer header with a valid MCP access token. Tokens are tied to an active subscription, can be created, rotated and revoked from your account page, and the raw value is shown only once at creation time.
Tools
The server exposes the following tools. All tools require authentication. Usage is metered per returned record.
find_contact_by_email
Resolve one individual contact from an email address, returning name, title, department, company and market context.
Parameters
| Name | Type | Required |
|---|---|---|
| string | Yes |
{ contact }Billing unit: CONTACTsearch_companies
Search company candidates by business ID, website domain or company name. Returns prioritized matches with match scores and match types.
Parameters
| Name | Type | Required |
|---|---|---|
| businessId | string | No |
| domain | string | No |
| companyName | string | No |
| limit | number | No |
{ companies[] }Billing unit: COMPANYfind_company
Resolve one company by business ID or company name. Ambiguous name matches return prioritized candidates instead of an arbitrary company.
Parameters
| Name | Type | Required |
|---|---|---|
| businessId | string | No |
| companyName | string | No |
{ company, candidates?, isAmbiguous? }Billing unit: COMPANYfind_company_by_email_domain
Find companies whose website domain matches the given domain. Useful for identifying the company behind an email address.
Parameters
| Name | Type | Required |
|---|---|---|
| domain | string | Yes |
{ companies[] }Billing unit: COMPANYfind_company_contacts
Retrieve contacts belonging to one company. Name lookups only proceed when the company match is clear; ambiguous matches return candidates. Returns up to 100 contacts.
Parameters
| Name | Type | Required |
|---|---|---|
| companyId | number | No |
| businessId | string | No |
| companyName | string | No |
| limit | number | No |
{ company, contacts[], candidates?, isAmbiguous? }Billing unit: CONTACTfind_contact_segment
Build a filtered target group using country, region, industry, responsibility, title, company financials and founding year filters. Returns a sample of up to 2,000 contacts plus total contact and employer counts.
Parameters
| Name | Type | Required |
|---|---|---|
| countryId | number | No |
| regionName | string | No |
| industryGroupId | number | No |
| industryId | number | No |
| mainResponsibilityAreaIds | number[] | No |
| jobFunctionIds | number[] | No |
| turnoverMin | number | No |
| turnoverMax | number | No |
| profitMin | number | No |
| profitMax | number | No |
| personnelMin | number | No |
| personnelMax | number | No |
| foundedYearMin | number | No |
| foundedYearMax | number | No |
| newContactsWithinDays | number | No |
| newResponsibilityAssignmentsWithinDays | number | No |
| limit | number | No |
{ totalCount, employerCount, returnedCount, contacts[] }Billing unit: CONTACTBilling
Each tool call that returns records creates a billable usage event. The number of returned contacts or companies is recorded. Calls that return no results are not charged. Usage is visible on your account page and included in monthly invoicing.
MCP Playground (coming next)
An interactive testing area is planned for advanced configuration. Until then, explore MCP use cases and manage access tokens from account settings.