MCP-dokumentaatio

MCP-palvelimen työkaluviite

Täydellinen viite kaikista NordicContacts MCP -palvelimen tarjoamista työkaluista. Käytä näitä työkaluja mistä tahansa MCP-yhteensopivasta AI-agentista yritysten, kontaktien ja kohderyhmien hakuun.

Pikaopas

Luo tili. Rekisteröidy täällä
Kelpoisuusehdot täyttävä uusi tili saa maksuttoman kokeilun rekisteröitymisen yhteydessä. Hallinnoi tilausta tilisivulla; OAuthia tukevissa asiakasohjelmissa ei tarvita manuaalista tokenia. Siirry tilille
Lisää alla oleva MCP-osoite MCP-asiakasohjelmaan, kuten Claudeen, kirjaudu NordicContacts-tililläsi avautuvassa selainikkunassa, hyväksy käyttöoikeus ja ota liitin käyttöön aloittaaksesi työkalujen kutsumisen.

Konfiguraatio

Lisää alla oleva MCP-osoite mihin tahansa MCP OAuthia tukevaan asiakasohjelmaan, kuten Claudeen, VS Codeen tai ChatGPT:hen. Kirjaudu sisään selaimessa; asiakasohjelma käsittelee tokenin automaattisesti.

OAuthia tukevat MCP-asiakasohjelmat

Käytä hostattua MCP-osoitetta suoraan. Manuaalista JSON-konfiguraatiota tai tokenia ei tarvita, jos asiakasohjelmasi tukee OAuthia.

MCP-osoite

https://nordiccontacts.eu/mcp

Lisää asiakasohjelmaasi uusi MCP-palvelin tai -liitin.
Liitä NordicContactsin MCP-osoite.
Kirjaudu NordicContacts-tililläsi selainikkunassa ja hyväksy käyttöoikeus.
Ota liitin käyttöön ja aloita työkalujen kutsuminen.

Asiakasohjelmat ilman OAuth-tukea

Jos MCP-asiakkaasi ei vielä tue MCP OAuthia, avaa tokenien hallinta luodaksesi tokenin ja kopioidaksesi siellä näkyvän valmiin JSON-konfiguraation oikealla token-arvolla.

Avaa tokenien hallinta

Palvelin käyttää HTTP Streamable -transporttia. OAuth on ensisijainen vaihtoehto, kun asiakas tukee sitä; muuten autentikointi tehdään Bearer-tokenilla Authorization-headerissa.

Autentikointi

Claude, VS Code, ChatGPT ja muut MCP OAuthia tukevat asiakasohjelmat pyytävät kirjautumaan sisään ja hyväksymään käyttöoikeuden, kun lisäät MCP-osoitteen; tokenia ei tarvitse luoda itse. Ilman OAuth-tukea asiakasohjelman on lähetettävä Authorization: Bearer -otsake, jossa on voimassa oleva manuaalinen MCP-token. Tokenit edellyttävät aktiivista tilausta tai maksutonta kokeilua, ne voi mitätöidä tilisivulla, ja manuaalisen tokenin täysi arvo näytetään vain luotaessa. Käyttöoikeustunnuksilla ei ole ennalta määrättyä vanhenemisaikaa; tokenin mitätöinti katkaisee kyseisen asiakasohjelman yhteyden, ja uudelleenyhdistäminen edellyttää kirjautumisvirran suorittamista uudelleen.

Työkalut

Palvelin tarjoaa seuraavat työkalut. Kaikki työkalut vaativat autentikoinnin. Löytö-, luokittelu- ja laskentatyökalut ovat maksuttomia; hakutyökalut kuluttavat tilisi jaettua tilaussaldoa vähintään 1 yksikön per kutsu.

describe_tools

Listaa käytettävissä olevat MCP-työkalut ryhmiteltynä käyttötarkoituksen mukaan sekä ohjeet avainsanakategorioiden ja yrityslistojen käyttöön. Sopii työkalujen löytämiseen ennen muiden työkalujen kutsumista.

Parametrit

Nimi	Tyyppi	Pakollinen
includeExamples	boolean	Ei

Palauttaa: { server, tools[], guidance }Laskutusyksikkö: Maksuton

service_info

Palauttaa palvelun tiedot, hinnaston, käyttöönoton vaiheet sekä kirjautuneen tilin tilauksen ja jäljellä olevan kiintiön.

Parametrit

Nimi	Tyyppi	Pakollinen

Palauttaa: { service, pricing, setup, multiUser, account }Laskutusyksikkö: Maksuton

find_contact_by_email

Hakee yhden yhteyshenkilön tunnetulla sähköpostiosoitteella. Palauttaa enintään yhden yhteyshenkilön nimineen, tehtävineen, vastuualueineen, työnantajineen ja markkinatietoineen. Maksaa 1 yhteyshenkilöyksikön per kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
email	string	Kyllä

Palauttaa: { contact }Laskutusyksikkö: CONTACT

find_companies

Hakee yrityksiä sisäisellä companyId-tunnuksella, businessId-rekisteritunnuksella, verkkotunnuksella tai yritysnimellä tunnistamista varten (tyypillisesti 1–3 parasta osumaa). companyId on sisäinen tietokantatunnus, joka palautetaan yritystiedoissa id-kentässä ja yhteyshenkilöriveillä companyId-kentässä; se ei ole Y-tunnus tai muu yrityksen rekisteritunnus. Hae täydet yritystiedot companyId-tunnuksella: se ohittaa muut tunnistustiedot, mutta countryId rajaa hakua edelleen. Palauttaa yksiselitteisen osuman resolvedCompany-kentässä ilman candidates-kenttää; muussa tapauksessa palauttaa järjestetyt ehdokkaat osumapisteineen ja moniselitteisyystietoineen. Ehdokkaiden määrän oletusraja on 10 ja enimmäisraja 20. Veloittaa 1 yritysyksikön ratkaistusta osumasta tai 1 yksikön per palautettu ehdokas moniselitteisen tuloksen tapauksessa (vähintään 1 yksikkö per kutsu).

Parametrit

Nimi	Tyyppi	Pakollinen
companyId	number	Ei
businessId	string	Ei
domain	string	Ei
companyName	string	Ei
countryId	number	Ei
limit	number	Ei

Palauttaa: { resolvedCompany, candidates?: Company[], isAmbiguous }Laskutusyksikkö: COMPANY

resolve_company_by_domain

Hakee yritykset tarkalla verkkotunnuksella — nopein suora haku. Palauttaa yhden osuman resolvedCompany-kentässä ilman candidates-kenttää; useat osumat palauttavat isAmbiguous=true ja candidates-listan, ja jos osumia ei ole, candidates-lista on tyhjä. Määrän oletus- ja enimmäisraja on 20. Maksaa 1 yritysyksikön per palautettu yritys, vähintään 1 yksikkö per kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
domain	string	Kyllä
countryId	number	Ei
limit	number	Ei

Palauttaa: { resolvedCompany, candidates?: Company[], isAmbiguous }Laskutusyksikkö: COMPANY

list_company_contacts

Hakee yhteen yritykseen kuuluvat yhteyshenkilöt deterministisellä limit/offset-sivutuksella. Palauttaa täydet yritystiedot kerran resolvedCompany-kentässä ilman candidates-kenttää sekä tiiviit yhteyshenkilörivit, joissa on henkilötiedot ja companyId toistuvien yritystietojen sijaan. Moniselitteinen yritysnimi palauttaa ehdokkaat tarkempaa tunnistusta varten. Maksaa 1 yhteyshenkilöyksikön per palautettu yhteyshenkilö, vähintään 1 yksikkö per kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
companyId	number	Ei
businessId	string	Ei
companyName	string	Ei
countryId	number	Ei
contactInfoFilter	'email' \| 'phone' \| 'both'	Ei
limit	number	Ei
offset	number	Ei

Palauttaa: { resolvedCompany, candidates?: Company[], isAmbiguous, contacts[] }Laskutusyksikkö: CONTACT

list_countries

Listaa käytettävissä olevat tuetut maat — Suomen, Ruotsin ja Viron — sekä niiden countryId-suodattimissa käytettävät tunnukset. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
search	string	Ei
limit	number	Ei

Palauttaa: { countries[] }Laskutusyksikkö: Maksuton

list_industry_groups

Listaa ylemmän tason toimialaryhmät tunnuksineen industryGroupIds-suodatinta varten. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
search	string	Ei
limit	number	Ei

Palauttaa: { industryGroups[] }Laskutusyksikkö: Maksuton

list_industries

Listaa maan yksityiskohtaiset toimialakoodit (Suomi: TOL 2025, Ruotsi: SNI 2025, Viro: EMTAK 2025) industryCodes-suodatinta varten. Haku kohdistuu englanninkielisiin nimiin, toimialakoodeihin ja paikalliskielisiin nimiin silloin, kun ne ovat saatavilla (Suomessa suomeksi ja Ruotsissa ruotsiksi; esim. programming, ohjelmisto, datakonsult). Oletus on 200 tulosta ja enimmäismäärä 500; sivuta offset-parametrilla. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
search	string	Ei
limit	number	Ei
offset	number	Ei
countryId	number	Kyllä

Palauttaa: { industries[] }Laskutusyksikkö: Maksuton

list_main_responsibility_areas

Listaa laajat vastuualueet (esim. myynti, IT, markkinointi) tunnuksineen mainResponsibilityAreaIds-suodatinta varten. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
search	string	Ei
limit	number	Ei

Palauttaa: { mainRespTypes[] }Laskutusyksikkö: Maksuton

list_job_functions

Listaa tehtäväfunktiot tunnuksineen jobFunctionIds-suodatinta varten; tarkempia kuin päävastuualueet. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
search	string	Ei
limit	number	Ei

Palauttaa: { jobFunctions[] }Laskutusyksikkö: Maksuton

list_keyword_categories

Listaa kaikki päätason yritysten avainsanakategoriat kanonisine nimineen sekä suomen-, ruotsin- ja englanninkielisine nimineen keywordCategoryFilter-suodatinta varten. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen

Palauttaa: { categories[] }Laskutusyksikkö: Maksuton

search_keyword_subcategories

Hakee yritysten avainsana-alakategorioita kanonisella tai lokalisoidulla sanamuodolla, haluttaessa rajattuna pääkategorioihin, keywordCategoryFilter-suodatinta varten. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
search	string	Ei
mainCategories	string[]	Ei
limit	number	Ei
offset	number	Ei

Palauttaa: { subcategories[] }Laskutusyksikkö: Maksuton

count_contact_segment

Laskee segmenttisuodattimia vastaavien yhteyshenkilöiden määrän lataamatta yhteyshenkilörivejä — käytä "kuinka monta yhteyshenkilöä" -kysymyksiin. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
companyId	number	Ei
businessId	string	Ei
countryId	number	Kyllä
regionName	string	Ei
industryGroupIds	number[]	Ei
industryCodes	string[]	Ei
mainResponsibilityAreaIds	number[]	Ei
jobFunctionIds	number[]	Ei
turnoverMin	number	Ei
turnoverMax	number	Ei
profitMin	number	Ei
profitMax	number	Ei
personnelMin	number	Ei
personnelMax	number	Ei
foundedYearMin	number	Ei
foundedYearMax	number	Ei
newContactsWithinDays	number	Ei
newResponsibilityAssignmentsWithinDays	number	Ei
contactInfoFilter	'email' \| 'phone' \| 'both'	Ei
organizationLevels	string[]	Ei
webshopStatus	'identified' \| 'not_identified' \| 'not_crawled'	Ei
webshopPlatforms	string[]	Ei
targetMarket	'b2b' \| 'b2c' \| 'both' \| 'unknown' \| 'not_crawled'	Ei
keywordCategoryFilter	object	Ei
customerListMode	'ignore' \| 'exclude' \| 'limit'	Ei

Palauttaa: { totalCount }Laskutusyksikkö: Maksuton

count_company_segment

Laskee segmenttisuodattimia vastaavien yritysten määrän lataamatta rivejä — käytä "kuinka monta yritystä" -kysymyksiin. Maksuton kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
companyId	number	Ei
businessId	string	Ei
countryId	number	Kyllä
regionName	string	Ei
industryGroupIds	number[]	Ei
industryCodes	string[]	Ei
mainResponsibilityAreaIds	number[]	Ei
jobFunctionIds	number[]	Ei
turnoverMin	number	Ei
turnoverMax	number	Ei
profitMin	number	Ei
profitMax	number	Ei
personnelMin	number	Ei
personnelMax	number	Ei
foundedYearMin	number	Ei
foundedYearMax	number	Ei
newContactsWithinDays	number	Ei
newResponsibilityAssignmentsWithinDays	number	Ei
companyContactFilter	'all' \| 'email' \| 'phone' \| 'both'	Ei
organizationLevels	string[]	Ei
webshopStatus	'identified' \| 'not_identified' \| 'not_crawled'	Ei
webshopPlatforms	string[]	Ei
targetMarket	'b2b' \| 'b2c' \| 'both' \| 'unknown' \| 'not_crawled'	Ei
keywordCategoryFilter	object	Ei
customerListMode	'ignore' \| 'exclude' \| 'limit'	Ei

Palauttaa: { totalCount }Laskutusyksikkö: Maksuton

list_contact_segment

Palauttaa suodatetun yhteyshenkilösegmentin samoilla kriteereillä kuin verkkosivun haku, deterministisellä limit/offset-sivutuksella. Tiiviit rivit sisältävät henkilötiedot, companyId-tunnuksen ja työnantajan perustiedot ilman yrityksen täydellistä kuvausta tai taloustietoja. Oletus on 100 yhteyshenkilöä, ja sivulla palautetaan enintään 100; hae seuraavat sivut offset-parametrilla. Maksaa 1 yhteyshenkilöyksikön per palautettu yhteyshenkilö, vähintään 1 yksikkö per kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
companyId	number	Ei
businessId	string	Ei
countryId	number	Kyllä
regionName	string	Ei
industryGroupIds	number[]	Ei
industryCodes	string[]	Ei
mainResponsibilityAreaIds	number[]	Ei
jobFunctionIds	number[]	Ei
turnoverMin	number	Ei
turnoverMax	number	Ei
profitMin	number	Ei
profitMax	number	Ei
personnelMin	number	Ei
personnelMax	number	Ei
foundedYearMin	number	Ei
foundedYearMax	number	Ei
newContactsWithinDays	number	Ei
newResponsibilityAssignmentsWithinDays	number	Ei
contactInfoFilter	'email' \| 'phone' \| 'both'	Ei
organizationLevels	string[]	Ei
webshopStatus	'identified' \| 'not_identified' \| 'not_crawled'	Ei
webshopPlatforms	string[]	Ei
targetMarket	'b2b' \| 'b2c' \| 'both' \| 'unknown' \| 'not_crawled'	Ei
keywordCategoryFilter	object	Ei
customerListMode	'ignore' \| 'exclude' \| 'limit'	Ei
limit	number	Ei
offset	number	Ei

Palauttaa: { contacts[] }Laskutusyksikkö: CONTACT

list_company_segment

Listaa segmenttikriteerit täyttävät yritykset (maa, toimiala, koko, verkkokauppa, kohdemarkkina, avainsanat) deterministisellä sivutuksella. Oletus on 100 yritystä, ja sivulla palautetaan enintään 100; hae seuraavat sivut offset-parametrilla. Maksaa 1 yritysyksikön per palautettu yritys, vähintään 1 yksikkö per kutsu.

Parametrit

Nimi	Tyyppi	Pakollinen
companyId	number	Ei
businessId	string	Ei
countryId	number	Kyllä
regionName	string	Ei
industryGroupIds	number[]	Ei
industryCodes	string[]	Ei
mainResponsibilityAreaIds	number[]	Ei
jobFunctionIds	number[]	Ei
turnoverMin	number	Ei
turnoverMax	number	Ei
profitMin	number	Ei
profitMax	number	Ei
personnelMin	number	Ei
personnelMax	number	Ei
foundedYearMin	number	Ei
foundedYearMax	number	Ei
newContactsWithinDays	number	Ei
newResponsibilityAssignmentsWithinDays	number	Ei
companyContactFilter	'all' \| 'email' \| 'phone' \| 'both'	Ei
organizationLevels	string[]	Ei
webshopStatus	'identified' \| 'not_identified' \| 'not_crawled'	Ei
webshopPlatforms	string[]	Ei
targetMarket	'b2b' \| 'b2c' \| 'both' \| 'unknown' \| 'not_crawled'	Ei
keywordCategoryFilter	object	Ei
customerListMode	'ignore' \| 'exclude' \| 'limit'	Ei
limit	number	Ei
offset	number	Ei

Palauttaa: { companies[] }Laskutusyksikkö: COMPANY

Laskutus

Starter ja Pro käyttävät samaa jaettua saldoa MCP:ssä, REST API:ssa ja tilattavissa Excel-vienneissä. Ensin kuluvat kuukausittaiset sisältyvät kontaktit, sitten ennakkoostetut lisäkontaktit. Kertaluonteiset Excel-ostot ovat erillisiä ja käyttävät omaa tilausvirtaansa. Jokainen mittaroitu työkalukutsu maksaa vähintään 1 yksikön; useimmat hakutyökalut veloittavat lisäksi 1 yksikön per palautettu rivi. Kunkin työkalun laskutusyksikkö on lueteltu alla.

MCP Playground (tulossa)

Interaktiivinen testialue on tulossa edistyneeseen konfigurointiin. Siihen asti tutustu MCP-käyttötapauksiin ja hallitse käyttötokeneita tilin asetuksista.

Tutustu MCP-käyttötapauksiin Avaa REST API -sivu Hallitse MCP-tiliä

Katso paketit Siirry tilille