@loikka/vainu-mcp

MCP (Model Context Protocol) server for Vainu company intelligence API. Gives Claude direct access to company data, contacts, business signals, and prospecting across Nordic markets.

Quick Start

# Run directly with npx (no install needed)
npx @loikka/vainu-mcp

# Or install globally
npm install -g @loikka/vainu-mcp
vainu-mcp

Configuration

Set your Vainu API key as an environment variable:

export VAINU_API_KEY=your_key_here

Claude Desktop / Cowork

Add to your MCP configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "vainu": {
      "command": "npx",
      "args": ["@loikka/vainu-mcp"],
      "env": {
        "VAINU_API_KEY": "your_key_here"
      }
    }
  }
}

Claude Code CLI

claude mcp add vainu -- npx @loikka/vainu-mcp

Available Tools

| Tool | Description | |------|-------------| | vainu_search_companies | Search companies by name, industry, technology, or size | | vainu_get_company | Get full company profile by business ID or name | | vainu_find_similar | Find companies similar to a reference company | | vainu_get_signals | Get recent business signals (funding, hiring, tech changes) | | vainu_search_contacts | Find decision-makers at a company | | vainu_prospect_list | Build a prospect list based on ICP criteria |

Tool Details

vainu_search_companies

Search for companies across Nordic markets.

Parameters:

• query (required): Search term — company name, industry, or technology
• country: FI, SE, NO, DK (default: FI)
• industry: Industry filter
• min_employees: Minimum employee count
• technologies: Technology filter (e.g., "Salesforce", "SAP")

vainu_get_company

Get complete company profile.

Parameters:

• business_id: Finnish Y-tunnus (format: 1234567-8)
• company_name: Company name (alternative to business_id)
• country: FI, SE, NO, DK (default: FI)

vainu_find_similar

Find companies with similar characteristics using Vainu's AI.

Parameters:

• business_id (required): Reference company business ID
• country: Search country (default: FI)
• limit: Max results (default: 10)

vainu_get_signals

Get recent business events and signals.

Parameters:

• business_id: Company business ID
• company_name: Company name (alternative to business_id)
• country: FI, SE, NO, DK (default: FI)

Signal types: Funding rounds, management changes, job postings, technology adoptions, office moves, revenue changes, news mentions.

vainu_search_contacts

Find people at a company.

Parameters:

• business_id: Company business ID
• company_name: Company name (alternative to business_id)
• role_filter: Title filter (e.g., "CEO", "CTO", "Sales Director")
• country: FI, SE, NO, DK (default: FI)

vainu_prospect_list

Build a targeted prospect list.

Parameters:

• industry: Industry filter
• min_revenue: Minimum annual revenue (EUR)
• min_employees: Minimum headcount
• technologies: Required technology
• country: FI, SE, NO, DK (default: FI)
• limit: Max results (default: 25, max: 100)

API Reference

This server uses Vainu's REST API:

• v2 API (api.vainu.io/api/v2/): Company search, company details, contacts
• v3 API (api.vainu.io/api/v3/): Similar organizations (AI-powered)

Authentication is via organization-level API token (Authorization: Token <key>).

Rate Limiting

• 60 requests per minute (client-side throttling)
• Vainu may impose additional server-side limits
• The server returns helpful error messages when limits are hit

Finnish Business ID (Y-tunnus)

The server validates and handles Finnish business IDs:

• Format: 1234567-8 (7 digits, dash, check digit)
• Company name suffixes (Oy, Ab, Oyj, Ltd) are stripped for better search

Development

# Install dependencies
npm install

# Run in development mode
VAINU_API_KEY=your_key npm run dev

# Build for production
npm run build

# Run built version
VAINU_API_KEY=your_key npm start

License

MIT - Loikka Solutions Oy

Author

Loikka Solutions Oy — Salesforce consulting & AI automation for Nordic companies.