Skip to main content
Glama
aHk-coder

finn-mcp

by aHk-coder
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FINN_BACKENDNoBackend selection: 'scraper' (default) or 'official' (stub).scraper

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.
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.
save_searchB

Persist a named search for repeated monitoring via check_saved_search.

list_saved_searchesA

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

delete_saved_searchA

Delete a saved search by name. Returns True if it existed.

check_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".

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

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

ActivityInactive
ResponsivenessNo issues

Resources