⚠️ Vainu MCP is an additional feature that isn't automatically available to all users. You can reach out to your CS Manager at Vainu or customersuccess@vainu.io to enquire about your options to access the feature.
What is an MCP?
MCP or Model Context Protocol is a framework intended to integrate AI assistants to external systems or data sources. In simpler terms, it is the bridge between our Nordic B2B business data and the capabilities of modern AI tools such as Gemini or Claude. Vainu MCP gives your AI agents and assistants access to our up-to-date data, so you can research, score, and act on company information faster and at scale.
How to access Vainu MCP?
🤖 Vainu MCP server URL: https://mcp.vainu.ai/mcp
The method in which to access Vainu MCP varies depending on your AI assistant of choice. Here are instructions for the most commonly used tools that currently support MCPs.
Claude
Go to Settings -> Connectors -> Add MCP Server
Enter the server URL:
https://mcp.vainu.ai/mcpComplete the OAuth login to authenticate your Vainu account
ChatGPT
Go to Settings -> Connectors
Add a new MCP server and enter the server URL:
https://mcp.vainu.ai/mcpFollow the guided OAuth flow to connect your Vainu account
Cursor
Add Vainu MCP as a server in Cursor's MCP configuration, pointing to https://mcp.vainu.ai/mcp. Follow the OAuth flow when prompted.
Gemini CLI
Add the following entry to ~/.gemini/settings.json:
{ "mcpServers": { "vainu": { "url": "https://mcp.vainu.ai/mcp" } } }
Microsoft Copilot Studio
Add Vainu MCP as a connector using the server URL https://mcp.vainu.ai/mcp. Authentication uses OAuth 2.0 with PKCE, which Copilot Studio supports natively.
Other MCP-compatible clients
Any client that supports HTTP/SSE transport and OAuth 2.0 with PKCE can connect to Vainu MCP. Use the server URL https://mcp.vainu.ai/mcp.
What can you do with Vainu MCP and how?
Using Vainu MCP does not require any deeper technical understanding, as all its capabilities can be accessed using natural language - discussing with your AI assistant. There is no need to switch between tools, as your AI client has access to Vainu's data, and can retrieve just the information you need on your behalf.
To see Vainu MCP in action, take a look at our demo video:
Once connected, your AI assistant of choice gains access to the following capabilities:
Capability | Description |
Company search & research | Find companies by name, business ID, or domain across our Nordic databases. Get rich profiles including website content, financials, signals, and documents. |
Advanced prospecting (VQL) | Build and run complex queries using Vainu Query Language to match your exact ICP. |
Event & signal discovery | Identify companies with relevant trigger events (hiring, expansions, won contracts, etc.) |
Document search | Vector-search across job postings, meeting minutes, budgets, ESG reports, and more |
Field discovery | Discover all available data fields and their metadata before building queries |
Some example queries to get you started
Company search & research
"Search for companies named Nokia in Finland"
"Find companies with domain elisa.fi"
"Get company context for business ID FI1234567-8 including website content and latest financials"
Advanced prospecting
"Find SaaS companies in Helsinki with a turnover of over €1M"
"What fields should I use when filtering for construction companies in Sweden?"
"Show me companies in Norway using Salesforce with more than 50 employees"
Event & signal discovery
"What event types are relevant for companies doing layoffs in Norway?"
"Find companies in Denmark that have recently posted senior sales roles"
"Suggest event types to new product launches in Sweden"
Document search
"Find budget documents and meeting minutes for municipalities in Finland"
"What ESG reports mention sustainability targets in Norwegian companies?"
"Find job postings for IT roles in Finnish healthcare companies"
Frequently asked questions
Is Vainu MCP included in my Vainu subscription?
Vainu MCP is an additional feature and requires specific permissions. Contact your Vainu contact person or email customersuccess@vainu.io to get access.
Which countries does Vainu MCP support?
Vainu MCP currently supports Finland (FI), Sweden (SE), Norway (NO), and Denmark (DK) — subject to the country databases included in your contract.
Which AI tools can I connect Vainu MCP to?
Any AI tool that supports MCP over HTTP/SSE transport and OAuth 2.0 can connect to Vainu MCP. Tested and supported clients include Claude, ChatGPT, Cursor, Gemini CLI, and Microsoft Copilot Studio.
Do I need Vainu Discovery Agent for document search?
Yes — semantic/vector document search via the
document_searchtool requires a separate Vainu Discovery Agent permission. Contact your Vainu contact person to confirm your access.How is Vainu MCP different from the Vainu Connector (CRM integration)?
While Connector pushes Vainu's data into your CRM (HubSpot, Salesforce, etc.) as structured fields, Vainu MCP gives AI assistants live, conversational access to the full depth of Vainu's data — including document search, signal discovery, and VQL queries — directly within the AI tool.
The AI assistant seems to call many tools automatically — is that normal?
Yes! For complex queries (like VQL searches), your AI assistant will chain multiple Vainu MCP tools automatically — for example, it may call get_query_reference, search_filter_values, and validate_query before running the final query. This is by design and ensures accurate results.
Technical reference
These are the specific tools Vainu MCP exposes to your AI assistant. You don't need to call them manually nor do you need to learn these for basic use - your AI assistant uses them automatically based on your prompts. This technical reference is intended to provide additional context into the current capabilities of Vainu MCP.
search_companies
Parameter | Required | Type | Description |
| Yes | string | Business ID, domain, or company name |
| No | string |
|
| No | number | Max results (1-100), defaulting to 20 |
get_company_context
Parameter | Required | Type | Description |
| Yes | string |
|
| Yes | string | Business ID (e.g. "FI123456789") |
| Yes | string[] | Field paths to include - use |
| Yes | boolean | Include the company's website contents |
| Yes | boolean | Include the latest financial statement |
| No | number[] | Event type IDs to filter relevant signals (from |
| No | string[] | Document types: |
query_organizations (VQL)
This tool executes advanced queries using Vainu Query Language (VQL). Your AI assistant will use get_query_reference, search_filter_values, and validate_query to build and validate the query before running it.
Parameter | Required | Type | Description |
| Yes | object | VQL query object e.g. |
| Yes | string |
|
| Yes | string[] | Field paths to return in results |
| No | string | Sort order, e.g. " |
| No | number | Max results, defaulting to 10 |
document_search
A vector search across a wide range of Nordic company documents - from job postings to municipal meeting minutes or ESG reports.
Parameter | Required | Type | Description |
| Yes | string | User search query in natural language |
| Yes | string[] | Document types to search - see list below |
| Yes | string | Start date in ISO format, e.g. " |
| Yes | number | Max results (1-100) |
| Yes | string[] | Country codes to filter by ( |
| No | string[] | Optionally limit search to specific companies |
Supported document types in document_search
Value | Description |
| Company annoucements |
| Blog posts |
| Municipal and company budget documents |
| Case studies |
| Decision maker profiles |
| ESG/sustainability reports |
| Events |
| Financial statements |
| Job postings / recruitment ads |
| Meeting minutes |
| News articles |
| Publications |
| Regulatory documents |
| Remiss/referral documents ( |
get_event_types_reference
Parameter | Required | Type | Description |
| No | string | 2-letter country code. If set, only returns event types available for specified country |
| No | boolean | If |
list_organization_fields
Parameter | Required | Type | Description |
| No | string | Search term to match field names or descriptions |
| No | string | Filter by category, e.g. " |
| No | string[] | Limit to fields available in specific countries |
| No | boolean | If true, returns only fields usable in VQL filters |
| No | number | Max fields to return (1-500), defaulting to 100 |
🕵🏻♀️ Contact Vainu Support if you have any questions! You can send an email to support@vainu.io or send a message through chat.