MCP-dokumentation
MCP-server verktygsreferens
Fullständig referens för alla verktyg som NordicContacts MCP-server exponerar. Använd dessa verktyg från vilken MCP-kompatibel AI-agent som helst för att slå upp företag, kontakter och bygga filtrerade målgrupper.
Snabbstart
- Skapa ett konto. Registrera dig här
- Nya konton som uppfyller villkoren får en kostnadsfri provperiod vid registreringen. Hantera prenumerationen från kontosidan; OAuth-kompatibla klienter behöver ingen manuell token. Gå till kontot
- Lägg till MCP-adressen nedan i en MCP-klient som Claude, logga in med ditt NordicContacts-konto i webbläsarfönstret som öppnas, godkänn åtkomsten och aktivera anslutningen för att börja anropa verktyg.
Konfiguration
Lägg till MCP-adressen nedan i en klient med stöd för MCP OAuth, till exempel Claude, VS Code eller ChatGPT. Logga in via webbläsaren; klienten hanterar token automatiskt.
OAuth-kompatibla MCP-klienter
Använd den hostade MCP-adressen direkt. Ingen manuell JSON-konfiguration eller token behövs om din klient stöder OAuth.
MCP-slutpunkt
https://nordiccontacts.eu/mcp
- Lägg till en ny MCP-server eller anslutning i din klient.
- Klistra in NordicContacts MCP-adress.
- Logga in med ditt NordicContacts-konto i webbläsarfönstret och godkänn åtkomsten.
- Aktivera anslutningen och börja anropa verktyg.
Klienter utan OAuth-stöd
Om din MCP-klient ännu inte stöder MCP OAuth öppnar du tokenhanteringen för att skapa en token och kopiera den färdiga JSON-konfigurationen där med det faktiska tokenvärdet.
Servern använder HTTP Streamable-transport. OAuth är förstahandsvalet när klienten stöder det; annars autentiserar du med en Bearer-token i Authorization-headern.
Autentisering
Claude, VS Code, ChatGPT och andra klienter med stöd för MCP OAuth ber dig logga in och godkänna åtkomst när du lägger till MCP-adressen; du behöver inte skapa en token manuellt. Klienter utan OAuth-stöd måste skicka en Authorization: Bearer-header med en giltig manuell MCP-token. Tokenar kräver en aktiv prenumeration eller kostnadsfri provperiod, kan återkallas från ditt konto och hela värdet för manuella tokenar visas bara när de skapas. Åtkomsttoken har ingen schemalagd giltighetstid; återkallar du en token kopplas den klienten bort, och återanslutning kräver att inloggningsflödet görs om.
Verktyg
Servern exponerar följande verktyg. Alla verktyg kräver autentisering. Upptäckts-, taxonomi- och räkneverktyg är kostnadsfria; hämtningsverktyg förbrukar kontots delade prenumerationssaldo med minst 1 enhet per anrop.
describe_tools
Listar tillgängliga MCP-verktyg grupperade efter syfte, med användningstips och vägledning för nyckelordskategorier och företagslistor. Användbart för att hitta verktyg innan andra verktyg anropas.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| includeExamples | boolean | Nej |
{ server, tools[], guidance }Debiteringsenhet: Kostnadsfriservice_info
Returnerar tjänstinformation, priser, konfigurationssteg samt det inloggade kontots prenumeration och återstående kvot.
Parametrar
| Namn | Typ | Obligatorisk |
|---|
{ service, pricing, setup, multiUser, account }Debiteringsenhet: Kostnadsfrifind_contact_by_email
Slår upp en enskild kontakt från en känd e-postadress. Returnerar högst en kontakt med namn, titel, ansvarsområde, arbetsgivare och marknadsinformation. Kostar 1 kontaktenhet per anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| string | Ja |
{ contact }Debiteringsenhet: CONTACTfind_companies
Hittar företag via internt companyId, businessId, webbdomän eller företagsnamn för identitetsupplösning (vanligtvis 1–3 bästa träffar). companyId är det interna databas-ID som returneras som id i företagsuppgifter eller companyId i kontaktrader, inte organisationsnumret. Använd companyId för att hämta fullständiga företagsuppgifter; det har företräde framför andra identifierare, medan countryId fortfarande begränsar sökningen. Returnerar en entydig träff i resolvedCompany utan candidates-fältet; annars returneras rankade kandidater med träffpoäng och tvetydighetsmetadata. Kandidatgränsen är som standard 10 och högst 20. Kostar 1 företagsenhet för en löst träff eller 1 enhet per returnerad kandidat vid tvetydigt resultat (minst 1 enhet per anrop).
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| companyId | number | Nej |
| businessId | string | Nej |
| domain | string | Nej |
| companyName | string | Nej |
| countryId | number | Nej |
| limit | number | Nej |
{ resolvedCompany, candidates?: Company[], isAmbiguous }Debiteringsenhet: COMPANYresolve_company_by_domain
Slår upp företag via exakt webbdomän — den snabbaste direkta uppslagningen. Returnerar en enskild träff i resolvedCompany utan candidates-fältet; flera träffar returnerar isAmbiguous=true och candidates, och inga träffar ger en tom candidates-lista. Gränsen är som standard 20 och högst 20. Kostar 1 företagsenhet per returnerat företag, minst 1 enhet per anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| domain | string | Ja |
| countryId | number | Nej |
| limit | number | Nej |
{ resolvedCompany, candidates?: Company[], isAmbiguous }Debiteringsenhet: COMPANYlist_company_contacts
Hämtar kontakter som tillhör ett företag, med deterministisk limit/offset-paginering. Returnerar fullständiga företagsuppgifter en gång i resolvedCompany utan candidates-fältet samt kompakta kontaktrader med personfält och companyId i stället för upprepade företagsuppgifter. Tvetydiga företagsnamn returnerar kandidater för vidare upplösning. Kostar 1 kontaktenhet per returnerad kontakt, minst 1 enhet per anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| companyId | number | Nej |
| businessId | string | Nej |
| companyName | string | Nej |
| countryId | number | Nej |
| contactInfoFilter | 'email' | 'phone' | 'both' | Nej |
| limit | number | Nej |
| offset | number | Nej |
{ resolvedCompany, candidates?: Company[], isAmbiguous, contacts[] }Debiteringsenhet: CONTACTlist_countries
Listar tillgängliga länder som stöds — Finland, Sverige och Estland — med de ID:n som används i countryId-filter. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| search | string | Nej |
| limit | number | Nej |
{ countries[] }Debiteringsenhet: Kostnadsfrilist_industry_groups
Listar branschgrupper på översta nivån med ID:n för industryGroupIds-filter. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| search | string | Nej |
| limit | number | Nej |
{ industryGroups[] }Debiteringsenhet: Kostnadsfrilist_industries
Listar detaljerade branschkoder för ett land (Finland: TOL 2025, Sverige: SNI 2025, Estland: EMTAK 2025) för industryCodes-filter. Sökningen matchar engelska namn, branschkoder och lokala namn där de finns (finska i Finland och svenska i Sverige; till exempel programming, ohjelmisto och datakonsult). Standard är 200 resultat och högst 500; använd offset för paginering. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| search | string | Nej |
| limit | number | Nej |
| offset | number | Nej |
| countryId | number | Ja |
{ industries[] }Debiteringsenhet: Kostnadsfrilist_main_responsibility_areas
Listar breda ansvarsområden (t.ex. försäljning, IT, marknadsföring) med ID:n för mainResponsibilityAreaIds-filter. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| search | string | Nej |
| limit | number | Nej |
{ mainRespTypes[] }Debiteringsenhet: Kostnadsfrilist_job_functions
Listar arbetsfunktioner med ID:n för jobFunctionIds-filter; mer detaljerade än huvudansvarsområdena. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| search | string | Nej |
| limit | number | Nej |
{ jobFunctions[] }Debiteringsenhet: Kostnadsfrilist_keyword_categories
Listar alla nyckelordskategorier på huvudnivå för företag med kanoniska namn samt finska, svenska och engelska etiketter för keywordCategoryFilter. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|
{ categories[] }Debiteringsenhet: Kostnadsfrisearch_keyword_subcategories
Söker bland företags nyckelordsunderkategorier med kanoniskt eller lokaliserat språk, eventuellt avgränsat till huvudkategorier, för keywordCategoryFilter. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| search | string | Nej |
| mainCategories | string[] | Nej |
| limit | number | Nej |
| offset | number | Nej |
{ subcategories[] }Debiteringsenhet: Kostnadsfricount_contact_segment
Räknar kontakter som matchar segmentfiltren utan att ladda kontaktposter — använd för "hur många kontakter"-frågor. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| companyId | number | Nej |
| businessId | string | Nej |
| countryId | number | Ja |
| regionName | string | Nej |
| industryGroupIds | number[] | Nej |
| industryCodes | string[] | Nej |
| mainResponsibilityAreaIds | number[] | Nej |
| jobFunctionIds | number[] | Nej |
| turnoverMin | number | Nej |
| turnoverMax | number | Nej |
| profitMin | number | Nej |
| profitMax | number | Nej |
| personnelMin | number | Nej |
| personnelMax | number | Nej |
| foundedYearMin | number | Nej |
| foundedYearMax | number | Nej |
| newContactsWithinDays | number | Nej |
| newResponsibilityAssignmentsWithinDays | number | Nej |
| contactInfoFilter | 'email' | 'phone' | 'both' | Nej |
| organizationLevels | string[] | Nej |
| webshopStatus | 'identified' | 'not_identified' | 'not_crawled' | Nej |
| webshopPlatforms | string[] | Nej |
| targetMarket | 'b2b' | 'b2c' | 'both' | 'unknown' | 'not_crawled' | Nej |
| keywordCategoryFilter | object | Nej |
| customerListMode | 'ignore' | 'exclude' | 'limit' | Nej |
{ totalCount }Debiteringsenhet: Kostnadsfricount_company_segment
Räknar företag som matchar segmentfiltren utan att ladda poster — använd för "hur många företag"-frågor. Kostnadsfritt anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| companyId | number | Nej |
| businessId | string | Nej |
| countryId | number | Ja |
| regionName | string | Nej |
| industryGroupIds | number[] | Nej |
| industryCodes | string[] | Nej |
| mainResponsibilityAreaIds | number[] | Nej |
| jobFunctionIds | number[] | Nej |
| turnoverMin | number | Nej |
| turnoverMax | number | Nej |
| profitMin | number | Nej |
| profitMax | number | Nej |
| personnelMin | number | Nej |
| personnelMax | number | Nej |
| foundedYearMin | number | Nej |
| foundedYearMax | number | Nej |
| newContactsWithinDays | number | Nej |
| newResponsibilityAssignmentsWithinDays | number | Nej |
| companyContactFilter | 'all' | 'email' | 'phone' | 'both' | Nej |
| organizationLevels | string[] | Nej |
| webshopStatus | 'identified' | 'not_identified' | 'not_crawled' | Nej |
| webshopPlatforms | string[] | Nej |
| targetMarket | 'b2b' | 'b2c' | 'both' | 'unknown' | 'not_crawled' | Nej |
| keywordCategoryFilter | object | Nej |
| customerListMode | 'ignore' | 'exclude' | 'limit' | Nej |
{ totalCount }Debiteringsenhet: Kostnadsfrilist_contact_segment
Returnerar ett filtrerat kontaktsegment med samma kriterier som webbsökningen, med deterministisk limit/offset-paginering. Kompakta rader innehåller personfält, companyId och grundläggande arbetsgivarinformation, utan fullständiga företagsbeskrivningar eller ekonomiska uppgifter. Standard är 100 kontakter och högst 100 returneras per sida; använd offset för följande sidor. Kostar 1 kontaktenhet per returnerad kontakt, minst 1 enhet per anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| companyId | number | Nej |
| businessId | string | Nej |
| countryId | number | Ja |
| regionName | string | Nej |
| industryGroupIds | number[] | Nej |
| industryCodes | string[] | Nej |
| mainResponsibilityAreaIds | number[] | Nej |
| jobFunctionIds | number[] | Nej |
| turnoverMin | number | Nej |
| turnoverMax | number | Nej |
| profitMin | number | Nej |
| profitMax | number | Nej |
| personnelMin | number | Nej |
| personnelMax | number | Nej |
| foundedYearMin | number | Nej |
| foundedYearMax | number | Nej |
| newContactsWithinDays | number | Nej |
| newResponsibilityAssignmentsWithinDays | number | Nej |
| contactInfoFilter | 'email' | 'phone' | 'both' | Nej |
| organizationLevels | string[] | Nej |
| webshopStatus | 'identified' | 'not_identified' | 'not_crawled' | Nej |
| webshopPlatforms | string[] | Nej |
| targetMarket | 'b2b' | 'b2c' | 'both' | 'unknown' | 'not_crawled' | Nej |
| keywordCategoryFilter | object | Nej |
| customerListMode | 'ignore' | 'exclude' | 'limit' | Nej |
| limit | number | Nej |
| offset | number | Nej |
{ contacts[] }Debiteringsenhet: CONTACTlist_company_segment
Listar företag som matchar segmentkriterierna (land, bransch, storlek, webbshop, målmarknad, nyckelord) med deterministisk paginering. Standard är 100 företag och högst 100 returneras per sida; använd offset för följande sidor. Kostar 1 företagsenhet per returnerat företag, minst 1 enhet per anrop.
Parametrar
| Namn | Typ | Obligatorisk |
|---|---|---|
| companyId | number | Nej |
| businessId | string | Nej |
| countryId | number | Ja |
| regionName | string | Nej |
| industryGroupIds | number[] | Nej |
| industryCodes | string[] | Nej |
| mainResponsibilityAreaIds | number[] | Nej |
| jobFunctionIds | number[] | Nej |
| turnoverMin | number | Nej |
| turnoverMax | number | Nej |
| profitMin | number | Nej |
| profitMax | number | Nej |
| personnelMin | number | Nej |
| personnelMax | number | Nej |
| foundedYearMin | number | Nej |
| foundedYearMax | number | Nej |
| newContactsWithinDays | number | Nej |
| newResponsibilityAssignmentsWithinDays | number | Nej |
| companyContactFilter | 'all' | 'email' | 'phone' | 'both' | Nej |
| organizationLevels | string[] | Nej |
| webshopStatus | 'identified' | 'not_identified' | 'not_crawled' | Nej |
| webshopPlatforms | string[] | Nej |
| targetMarket | 'b2b' | 'b2c' | 'both' | 'unknown' | 'not_crawled' | Nej |
| keywordCategoryFilter | object | Nej |
| customerListMode | 'ignore' | 'exclude' | 'limit' | Nej |
| limit | number | Nej |
| offset | number | Nej |
{ companies[] }Debiteringsenhet: COMPANYDebitering
Starter och Pro använder samma delade saldo för MCP, REST API och prenumererade Excel-exporter. Inkluderade kontakter förbrukas först, därefter förbetalda påfyllningskontakter. Engångsköp av Excel är separata och använder ett eget orderflöde. Varje avgiftsbelagt verktygsanrop kostar minst 1 enhet; de flesta hämtningsverktyg debiterar dessutom 1 enhet per returnerad rad. Debiteringsenheten för varje verktyg anges nedan.
MCP Playground (kommer snart)
Ett interaktivt testområde planeras för avancerad konfiguration. Tills dess kan du utforska MCP-användningsfall och hantera åtkomsttokenar i kontoinställningarna.