MCP Setup

Connect your AI coding assistant directly to the Rich Utilities Leads API using Model Context Protocol (MCP). This enables your AI to search companies, manage leads, and access Nordic business data without leaving your editor.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and data sources. With MCP enabled, your AI can:

• Search companies across Norway, Sweden, Denmark, and Finland
• Retrieve detailed company information with contacts
• Create and manage your sales leads
• Export data for analysis
• Access industry classifications and geographic data

Claude Code (CLI)

Set up MCP for the Claude Code command-line interface.

Step 1: Get Your API Key

First, obtain an API key from your Rich Utilities dashboard:

Save the returned api_key - you'll only see it once.

Step 2: Configure Claude Code

Create or edit your Claude Code configuration file:

Add the MCP server configuration:

Step 3: Restart Claude Code

Exit and restart Claude Code to load the new configuration:

Step 4: Verify Setup

Ask Claude to test the connection:

If configured correctly, Claude will return company results.

VS Code

Configure MCP for VS Code with the Claude extension or other MCP-compatible extensions.

Using Claude for VS Code Extension

1. Install the Extension

   • Open VS Code
   • Go to Extensions (Cmd/Ctrl+Shift+X)
   • Search for "Claude"
   • Install the official Claude extension

2. Open Settings

   • Press Cmd/Ctrl+, to open settings
   • Search for "Claude MCP"

3. Add MCP Server In your VS Code settings.json:

4. Reload Window

   • Open Command Palette (Cmd/Ctrl+Shift+P)
   • Run "Developer: Reload Window"

5. Test in Chat

   • Open Claude chat panel
   • Ask: "Find me fintech companies in Sweden"

Cursor

Cursor supports MCP through its Composer feature.

Step 1: Open Cursor Settings

• Press Cmd/Ctrl+, to open Settings
• Navigate to "Features" → "Composer"

Step 2: Add MCP Server

Scroll to "MCP Servers" section and add:

Step 3: Enable in Composer

• Open Composer (Cmd/Ctrl+I)
• Click the "+" button to add tools
• Select "rich-utilities" from available MCP servers

Step 4: Start Using

In the Composer chat, ask natural language queries:

Windsurf

Windsurf (Codeium) supports MCP through cascade configuration.

Step 1: Locate Config Directory

Step 2: Create MCP Config

Create mcp.json in the config directory:

Step 3: Restart Windsurf

Close and reopen Windsurf to load the configuration.

Step 4: Use in Cascade

Open Cascade chat and ask:

Environment Variables

For all setups, you'll need these environment variables:

Storing API Keys Securely

macOS Keychain:

Windows Credential Manager: Use cmdkey or the Credential Manager UI to store the API key.

Environment File (.env):

Troubleshooting

MCP Server Not Found

Error: Cannot find module '@richutilities/mcp-server'

Solution:

Or use npx with the -y flag to auto-install:

Authentication Failed

Error: Invalid or expired token

Solution:

• Verify your API key is correct
• Generate a new key if needed:

Connection Timeout

Error: Request timeout

Solution:

• Check your internet connection
• Verify RICH_UTILITIES_BASE_URL is correct
• For self-hosted instances, ensure the server is accessible

Tools Not Appearing

Solution:

• Restart your editor completely
• Check the MCP server logs for errors
• Verify the JSON syntax in your config file

What Can You Do With MCP?

Once configured, your AI assistant can:

Search Companies

Get Company Details

Manage Leads

Export Data

Natural Language Queries