Cognism MCP server

Prebuilt SnapLogic agentic-tool pipelines that let an LLM read from and act on Cognism, callable as MCP tools via Pipeline Execute. Published in the SnapLogic pattern catalog.

Overview

This tool pack connects the Cognism B2B prospecting database to an agent, letting you search contacts and accounts, unlock full profiles by spending credits, and enrich existing records with verified emails, direct dials, and firmographics. You can also check credit balances, look up technology filter values, and verify opt-out status before outreach.

For setup instructions, see SnapLogic MCP Server quickstart.

Example Prompts

  • Enrich the company at www.cognism.com
  • What do we know about the company on this domain?
  • Look up Acme Corp in the UK — there are several, use the London one
  • Resolve this LinkedIn company page to a Cognism account record
  • Enrich this company but reject anything below an 80 match score
  • Redeem the account record for that company id
  • Unlock the full firmographics for the top ten accounts in that list
  • Get me the company phone numbers and offices for these account ids
  • Redeem these accounts without merging the location records
  • Find software companies that match our ICP in Cognism

Tools

Tool Name Functions
CognismAccountEnrich Enrich a known company from a name, domain, website or LinkedIn URL.
CognismAccountRedeem Unlock full account records for chosen search results, spending credits.
CognismAccountSearch Search the Cognism account index with a Cognism filter payload.
CognismContactEnrich Enrich a known person from an email, LinkedIn URL, name or phone.
CognismContactRedeem Unlock full contact details for chosen search results, spending credits.
CognismContactSearch Search the Cognism contact index with a Cognism filter payload.
CognismEntitlementAccount Check remaining account-credit entitlement on the subscription.
CognismEntitlementContact Check remaining contact-credit entitlement on the subscription.
CognismFilterTechnologies Look up valid technology filter values for tech-stack searches.
CognismOptOutCheck Check whether an email address has opted out of contact.

Set up the MCP Server tools

  1. Download cognism_tools.zip.
  2. In SnapLogic Designer, open the target project space (or create one), then choose Import Project / Import Pipelines and select the downloaded cognism_tools.zip. Designer unpacks each pipeline into the project.
  3. Attach the required account to the connectivity snaps (see Connection Setup).
  4. Expose the project as an MCP server — each pipeline becomes a tool named after its label. New to this? Start with the MCP quickstart, then use the MCP Server Pipeline Builder to generate the server from the imported pipelines.

Configure account

Attach an API Suite account (OAuth 2.0 or Bearer token) to the HTTP Client snap in Designer after import.

These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute.

See the SnapLogic account documentation for this connector: API Suite Account Configuration.

Important: These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute. Credentials live in the SnapLogic account store, never in the pipeline JSON.

CognismAccountEnrich

Enriches a known company's record using identifiers such as name, domain, website, or LinkedIn URL, and returns full firmographic data. Use it to fill in a CRM account record or turn a form-fill domain into a complete company profile.

Parameter Type Default Description
name string —

Company name to match.
domain string —

Company email domain.
website string —

Company website URL.
linkedin_url string —

LinkedIn company page URL.
country string —

Country, used to disambiguate similarly named companies.
city string —

City, used to disambiguate similarly named companies.
min_match_score integer —

Minimum match confidence; matches scoring below this are rejected.

Try asking:

  • Enrich the company at www.cognism.com
  • What do we know about the company on this domain?
  • Look up Acme Corp in the UK — there are several, use the London one
  • Resolve this LinkedIn company page to a Cognism account record
  • Enrich this company but reject anything below an 80 match score

CognismAccountRedeem

Unlocks full company records for a shortlist of account ids from a search, spending account credits. Use it after agreeing on a target-account list, rather than redeeming an entire result page.

Parameter Type Default Description
redeem_ids* string —

Comma-separated account redeem ids taken from an account-search result.
merge_phones_and_locations string —

Whether to merge phone numbers and locations into one record (default true).

* Required parameter.

Try asking:

  • Redeem the account record for that company id
  • Unlock the full firmographics for the top ten accounts in that list
  • Get me the company phone numbers and offices for these account ids
  • Redeem these accounts without merging the location records

CognismAccountSearch

Searches the Cognism account index using a firmographic filter and returns redeemable company records. Use it to build a target-account list or test how many companies match an ICP before drilling into contacts.

Parameter Type Default Description
search_json* string —

Cognism account-search filter payload, sent to the API as-is, e.g. {"names":["Cognism"],"industries":["Computer Software"]}.
index_size string —

Number of accounts to return per page (default 100).
last_returned_key string —

Cursor from a previous response; supply it to fetch the next page.

* Required parameter.

Try asking:

  • Find software companies that match our ICP in Cognism
  • Look up the Cognism account record for Cognism
  • Give me 100 computer software companies to build a target list from
  • Fetch the next page of account results from that search
  • Which accounts in the database match these industries and regions?

CognismContactEnrich

Looks up a known person in the Cognism database using partial identifiers and returns their enriched profile. Use it to fill CRM gaps, verify a job title, or confirm the right person before outreach.

Parameter Type Default Description
email string —

Email address of the person to match.
linkedin_url string —

LinkedIn profile URL of the person.
first_name string —

First name; usually combined with last name and an account identifier.
last_name string —

Last name; usually combined with first name and an account identifier.
job_title string —

Job title, used to disambiguate people with the same name.
account_name string —

Company name the person works at.
account_website string —

Company website the person works at.
phone_number string —

Phone number belonging to the person.
min_match_score integer —

Minimum match confidence; matches scoring below this are rejected.

Try asking:

  • Enrich this contact: [email protected]
  • Look up the person behind this LinkedIn profile URL
  • Who is Jane Doe, VP Marketing at Acme — can you fill in her details?
  • Match this name and company website to a Cognism contact, but only if the match score is above 80
  • Find the full record for the person on this phone number

CognismContactRedeem

Unlocks full contact profiles for selected search results, spending contact credits to reveal work email, direct dial, and location detail. Call it only for contacts the user has specifically chosen, as each redemption costs credits.

Parameter Type Default Description
redeem_ids* string —

Comma-separated contact redeem ids taken from a contact-search result.
merge_phones_and_locations string —

Whether to merge phone numbers and locations into one record (default true).

* Required parameter.

Try asking:

  • Unlock the contact details for the first three people from that search
  • Redeem this contact id and give me their direct dial
  • Get me the email addresses for these five prospects
  • Redeem these contacts but keep the phone numbers and locations unmerged

CognismContactSearch

Searches the Cognism contact index using a filter payload and returns matching people with redeem ids but without unlocked contact details. Use it as the first step of any prospecting task, then pass selected ids to CognismContactRedeem.

Parameter Type Default Description
search_json* string —

Cognism contact-search filter payload, sent to the API as-is, e.g. {"jobTitles":["CTO"],"regions":["EMEA"],"account":{"names":["Cognism"]}}.
index_size string —

Number of contacts to return per page (default 25).
last_returned_key string —

Cursor from a previous response; supply it to fetch the next page.

* Required parameter.

Try asking:

  • Find CTOs at software companies in EMEA
  • Search Cognism for heads of revenue operations at Cognism itself
  • Give me 50 VP-level marketing contacts in the UK
  • Get the next page of those contact results using the last returned key
  • Who are the senior finance decision makers at mid-market fintechs in Germany?

CognismEntitlementAccount

Reports the account-credit entitlement and remaining balance on the connected Cognism subscription. Use it to check available credits before running an account redemption.

No parameters.

Try asking:

  • How many account credits are left this period?
  • Check our Cognism account entitlement
  • Can we afford to redeem this whole target account list?
  • What's our account credit balance right now?

CognismEntitlementContact

Reports the contact-credit entitlement and remaining balance on the connected Cognism subscription. Use it before a large redemption run or when a user asks how many contact credits are left.

No parameters.

Try asking:

  • How many contact credits do we have left?
  • Check our Cognism contact entitlement before I redeem this list
  • What's our contact credit allowance on the current plan?
  • Do we have enough credits to unlock 200 contacts?

CognismFilterTechnologies

Looks up the technology values Cognism accepts as search filters, optionally narrowed by a search term. Use it before composing a tech-stack search to resolve a technology name to the exact filter value Cognism requires.

Parameter Type Default Description
search_term string —

Free-text term to narrow the technology list, e.g. Salesforce. Omit to browse all.
index_size string —

Number of technologies to return per page (default 20).
last_returned_key string —

Cursor from a previous response; supply it to fetch the next page.

Try asking:

  • What technology filters does Cognism have for Salesforce?
  • Show me the available technology values matching 'AWS'
  • List the first 20 technologies I can filter accounts by
  • Get the next page of technology filter options
  • Is there a filter for HubSpot, and what exactly is it called?

CognismOptOutCheck

Checks whether an email address has opted out in Cognism's suppression list and returns the opt-out status. Use it as a compliance check before adding a contact to a sequence or sending outreach.

Parameter Type Default Description
email* string —

Email address to check against Cognism's opt-out list.

* Required parameter.

Try asking:

  • Has [email protected] opted out?
  • Check this email against the Cognism suppression list before I add them to the sequence
  • Is it compliant to email this address?
  • Verify the opt-out status for this prospect's email