helmet
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
helmet
HelMet library catalogue (Helsinki, Espoo, Vantaa, Kauniainen), exposed over MCP.
Same shape as tori: no cache, no DB, no scheduler.
Not a scraper — HelMet's catalogue (helmet.finna.fi) is part of Finna, run
by the National Library of Finland, which has an open REST API at
https://api.finna.fi/. No API key. HelMet records are scoped with the
building:0/Helmet/ filter. src/finna.ts is a thin client over
/search and /record.
Tools
tool | what |
| terms, page, sort, filters, facets → records with owning branches |
| Finna ID → full metadata (authors, subjects, summary, e-links, branches) |
| a title → branches that own it, formats, free-online flag, other editions |
filters are Lucene fragments taken from a previous result's facets, e.g.
{ format: "1/Book/Book/", language: "fin", search_daterange_mv: "[2015 TO 2020]", free_online_boolean: "1" }.
Related MCP server: statfin-fi
Availability caveat
The open API returns collection holdings — which branches own a copy — not
real-time shelf status. There is no "3 available at Pasila right now" in
api.finna.fi; that lives behind the Finna web UI's authenticated ILS calls.
For live status, check helmet.finna.fi or the library.
Legality
Finna's API is meant for programmatic use. Metadata is mostly CC0/CC-BY (a few source-specific restrictions). This client only reads public catalogue data — no accounts, no personal data. House rules still apply: one request in flight, 500 ms gap, real User-Agent.
Run
bun install
bun test # hits the live API; set OFFLINE=1 to skip
bun run mcp # stdio MCP server (src/mcp/server.ts)
bun run mcp:http # streamable-HTTP MCP server on $MCP_PORT (default 3001), for hosting
claude mcp add helmet -- bun "$(pwd)/src/mcp/server.ts" # run from the repo rootFor a remote (hosted) server: claude mcp add --transport http helmet https://<host>/mcp.
Not here
Real-time availability — needs the authenticated Finna online interface / ILS. Would be
helmet.finna.fi/AJAX/JSON?method=getItemStatusesscraping; skipped on purpose.Personal account (loans, holds, fees, renew) — needs per-user credentials. Different tool, different legal posture. Not wired up.
No cache / scheduler / DB — stateless by design; add if a request ever needs it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search the Met collection, browse by department or update date, fetch full records and CC0 images.
Read-only search and retrieval of published books, articles and authors, with public catalog links.
Search books and authors, fetch editions, browse subjects, and resolve cover images.
Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides access to Sweden's National Library (Kungliga biblioteket) open APIs, enabling search and retrieval of 20M+ bibliographic records, 10M+ cultural heritage objects, 2M+ research publications, and linked data through 52 tools across 10 endpoints.3-
- AlicenseNot gradedqualityCmaintenanceEnables querying Statistics Finland's public statistical database using PxWeb API. Supports retrieving table metadata and pulling data with PxWeb query objects.69 npmMIT
- AlicenseAqualityBmaintenanceEnables accessing Finnish legislation from the Finlex open-data API, listing statutes by year and retrieving their full texts with ELI identifiers and Finnish citations.41Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables searching and querying Finland's open data portal (avoindata.fi) via CKAN. Supports dataset search, metadata retrieval, and tabular data queries.88 npmMIT