Finland Shopping MCP

An MCP server that helps an AI assistant shop in Finland by checking live prices and listings from Finnish marketplaces.

It is not limited to PC parts. You can ask for phones, furniture, appliances, tools, bikes, monitors, clothes, game consoles, cameras, computer parts, or almost anything else.

What It Searches

Related MCP server: PriceAtlas MCP Server

Installation

git clone https://github.com/xtofuub/suomi-shopping-mcp.git
cd suomi-shopping-mcp
python -m pip install -r requirements.txt

Running Manually

python server.py

The server uses MCP stdio transport. In normal use, your AI client starts it automatically.

AI Client Configuration

Add this to a Claude Desktop, Cursor, VS Code, or other MCP-compatible client config:

{
  "mcpServers": {
    "finland-shopping": {
      "command": "python",
      "args": ["C:\\path\\to\\suomi-shopping-mcp\\server.py"]
    }
  }
}

An example file is included at:

mcp-config.example.json

Tools

find_best_prices

Combined new-and-used price search across Hinta.fi and Tori.fi.

Use this for questions like:

• Find the best price for an iPhone 15 in Finland

• Is 250 euros good for a used Nintendo Switch OLED?

• Find a cheap office chair near Finnish used-market prices

• Compare new and used prices for a 4K monitor

Arguments:

search_hinta_products

Search Hinta.fi retail products.

Good for checking new-product prices, availability, store counts, and product pages.

get_hinta_product_details

Fetch a Hinta.fi product page by product ID and return store offers.

Example:

get_hinta_product_details(product_id="3236886")

search_tori_listings

Search Tori.fi used listings.

Arguments:

get_huuto_search_link

Returns a Huuto.net search URL for manual checking.

Huuto.net commonly blocks simple non-browser HTTP scraping, so this project intentionally does not fake unreliable parsed prices from it.

get_shopping_links

Returns direct Hinta.fi, Tori.fi, and Huuto.net search links for a query.

Compatibility Tools

These tool names remain available from the earlier Hinta/PC-part version:

• find_pc_part_prices

• search_products

• get_product_details

• get_deals

• get_categories

• get_category_products

Example Prompts

Find the best price for AirPods Pro 2 in Finland.

Is 400 euros a good used price for an RTX 4070 Super?

Find a washing machine under 250 euros, used is okay.

Compare new and used prices for a Herman Miller Aeron.

Build me a good gaming PC for 1000 euros using Finnish prices.

Output Shape

find_best_prices returns:

• summary.cheapest_overall

• summary.cheapest_new

• summary.cheapest_used

• summary.used_savings_vs_new

• results_sorted_by_price

• source URLs for manual verification

Prices are normalized to numeric EUR values when possible, with original listing text preserved where useful.

Limitations

• Marketplace HTML can change. If parsing breaks, update selectors in server.py.

• Used listings need human judgment. Check seller reputation, location, warranty, exact model, photos, pickup/shipping safety, and whether the listing is actually for sale rather than wanted.

• Hinta.fi and Tori.fi data is fetched live, so results can change between calls.

• Huuto.net is link-only in this MCP because bot protection makes direct scraping unreliable.

Development

Install dependencies:

python -m pip install -r requirements.txt

Compile check:

python -m py_compile server.py

Smoke test:

python test_server.py

License

MIT