Skip to main content
Glama

finn-mcp

MCP server that exposes finn.no — Norway's largest online classifieds marketplace — to Claude across four verticals:

  • BAP / Torget — used goods

  • Real estate — homes for sale and rentals

  • Cars — used (new cars are only available via the official API)

  • Jobs — full-time listings

Tools

Tool

Purpose

search_finn

Search a vertical by keyword + optional filters.

get_listing

Fetch a full listing by finnkode.

save_search

Persist a named recurring search.

list_saved_searches

List all saved searches.

delete_saved_search

Remove a saved search.

check_saved_search

Run a saved search and return only hits that are new since the last check.

Related MCP server: datakilder-mcp

Requires uv. Then use uvx to run the server without cloning or installing anything permanently:

uvx finn-mcp

Register with Claude Code

claude mcp add finn-mcp -- uvx finn-mcp

Or add to your .mcp.json (or Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "finn-mcp": {
      "command": "uvx",
      "args": ["finn-mcp"]
    }
  }
}

Data access

There is no self-serve public finn.no API. For v1 this server scrapes the public web pages and parses JSON-LD on detail pages. A stable FinnBackend interface separates the MCP surface from the data source, so the scraper can be swapped for the official partner API (cache.api.finn.no/iad/) later.

Backend selection is controlled by the FINN_BACKEND environment variable:

  • FINN_BACKEND=scraper (default) — the scraper implementation.

  • FINN_BACKEND=official — stub; raises NotImplementedError until partner credentials are wired up.

Responses are cached for 24 hours in a local SQLite database at $XDG_DATA_HOME/finn-mcp/cache.sqlite (defaults to ~/.local/share/finn-mcp/cache.sqlite).

Develop from source

git clone https://github.com/aHk-coder/finn-mcp
cd finn-mcp
uv sync
uv run pytest
uv run finn-mcp   # stdio server

Tests run against saved HTML fixtures in tests/fixtures/ and do not hit finn.no over the network.

License

MIT. See LICENSE.

Available Tools

6 tools
get_listingA

Fetch a full listing by its finnkode.

If ``vertical`` is omitted the server tries a cache hint first, then
probes each vertical until one returns a valid page. Results are cached
for 24 hours in a local SQLite database.

Inputs: finnkode (required), vertical. Returns: result

list_saved_searchesA

Return every saved search in the local store, ordered by name.

Inputs: no named parameters. Returns: result

search_finnA

Search finn.no within a vertical.

``vertical`` is one of: ``bap`` (Torget / used goods), ``homes`` (real
estate for sale), ``lettings`` (real estate for rent), ``cars_used``,
``cars_new`` (not yet supported by the scraper backend), ``jobs``.

``query`` is a free-text keyword. ``filters`` is a dict of extra
URL-query parameters understood by finn.no (e.g. ``{"price_to":"300000"}``
for cars, ``{"location":"1.20001.20061"}`` for Oslo).

Returns up to ~50 ``SearchResult`` entries. Fewer if finn.no returned
fewer matches; an empty list is a valid result.

Inputs: query (required), vertical (required), page, filters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: fetching a single listing, searching, and managing saved searches. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names use snake_case with a verb_noun pattern (get_listing, search_finn, save_search, etc.), consistently applied.

    Tool Count5/5

    6 tools is well-scoped for a finn.no interface, covering search, retrieval, and saved search lifecycle without bloat.

    Completeness4/5

    Core operations are present, but missing an update tool for saved search parameters and a way to list all results from a saved search (not just new ones). Minor gap.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server to find and fetch Norwegian open government data from data.norge.no. Enables search, metadata retrieval, and data download.
      5
      4
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      MCP server providing typed tools for Norwegian public data sources, enabling natural language queries to official datasets like SSB, Brønnøysund, MET, Kartverket, Entur, and more, without requiring API keys.
      47
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that searches Facebook Marketplace and Craigslist for items for sale, returning structured JSON listings with filtering, deduplication, and optional deep description checks.
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the Norwegian Central Coordinating Register for Legal Entities (Enhetsregisteret), providing tools to search companies, get full register records, list recent registrations, and retrieve registered roles.
      4
      MIT