finn-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@finn-mcp search for used cars under 200k NOK in Oslo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 a vertical by keyword + optional filters. |
| Fetch a full listing by |
| Persist a named recurring search. |
| List all saved searches. |
| Remove a saved search. |
| Run a saved search and return only hits that are new since the last check. |
Related MCP server: datakilder-mcp
Install & run (recommended)
Requires uv. Then use uvx to run the server
without cloning or installing anything permanently:
uvx finn-mcpRegister with Claude Code
claude mcp add finn-mcp -- uvx finn-mcpOr 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; raisesNotImplementedErroruntil 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 serverTests run against saved HTML fixtures in tests/fixtures/ and do not hit
finn.no over the network.
License
MIT. See LICENSE.
Available Tools
6 toolscheck_saved_searchA
Run a saved search, return only listings that are new since the last check.
Updates the saved search's ``last_checked_at`` and ``last_finnkodes``.
On the first call all current results are "new".
Inputs: name (required). Returns: result
delete_saved_searchA
Delete a saved search by name. Returns True if it existed.
Inputs: name (required). Returns: result
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
save_searchB
Persist a named search for repeated monitoring via check_saved_search.
Inputs: name (required), query (required), vertical (required), filters. Returns: name, query, filters, vertical, +2 more
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
Scored across 6 tools
Each tool has a clearly distinct purpose: fetching a single listing, searching, and managing saved searches. No overlap or ambiguity.
All tool names use snake_case with a verb_noun pattern (get_listing, search_finn, save_search, etc.), consistently applied.
6 tools is well-scoped for a finn.no interface, covering search, retrieval, and saved search lifecycle without bloat.
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
Related MCP Connectors
Public MCP server for discovering open jobs. Search, filter, and get application links.
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server to find and fetch Norwegian open government data from data.norge.no. Enables search, metadata retrieval, and data download.54MIT
- AlicenseBqualityBmaintenanceMCP 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.47MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that searches Facebook Marketplace and Craigslist for items for sale, returning structured JSON listings with filtering, deduplication, and optional deep description checks.4MIT
- AlicenseAqualityDmaintenanceMCP 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.4MIT