FINN.no MCP Server

A Model Context Protocol (MCP) server for searching and browsing Norwegian marketplaces — FINN.no and Klarna Price Guide.

Features

FINN.no Torget (secondhand marketplace)

• Search with filters for category, price, condition, location, colour, clothing size, and radius-based proximity
• Item details including description, images, seller info, and key specs

FINN.no Cars

• Search with filters for make, fuel type, body type, transmission, wheel drive, mileage, year, and price
• Item details with full specs (engine, mileage, VIN, registration, etc.)

FINN.no Boats

• Search with filters for boat class, length, engine power/type/fuel, year, and price
• Item details with full specs (length, width, speed, engine, materials, etc.)

FINN.no Holiday Homes

• Destination autocomplete to discover locations and result counts
• Property details including pricing, beds, facilities, house rules, and images

Klarna Price Guide (prisguiden.no)

• Search for new products across Norwegian retailers with lowest prices and price drop alerts
• Product details with all merchant offers sorted by price, and price trend data

Usage

Claude Code

Add to .mcp.json in your project root (or ~/.claude/.mcp.json for global access):

{
  "mcpServers": {
    "finn-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["github:viktorfa/finn_mcp"]
    }
  }
}

Alternative runners:

# bunx
"command": "bunx", "args": ["github:viktorfa/finn_mcp"]

# pnpm dlx
"command": "pnpm", "args": ["dlx", "github:viktorfa/finn_mcp"]

Claude Desktop

Add to your Claude Desktop config and restart Claude.

{
  "mcpServers": {
    "finn-mcp": {
      "command": "npx",
      "args": ["github:viktorfa/finn_mcp"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Examples

• "Search for 'skjorter' on FINN Torget"
• "Find electric cars under 300k on FINN"
• "Search for cabincruiser boats over 25 feet"
• "Find holiday cabins in Lofoten"
• "Compare prices for Raspberry Pi 4 on Klarna"
• "Get details for FINN item 343932826"

Development

git clone https://github.com/viktorfa/finn_mcp.git
cd finn_mcp
pnpm install
pnpm run dev

pnpm test         # run tests
pnpm run lint     # lint with biome
pnpm run format   # format with biome

Disclaimer

Please respect FINN.no's terms of service. Avoid excessive requests and automated scraping that could impact their servers.

License

MIT