Logo

FISHERMANS-LODGE · MCP

Model Context Protocol server for fishing holidays

Our public MCP catalogue lets compatible AI assistants search published fishing accommodation, activities, equipment and holiday packages, and answer species questions from our localized fish guides before opening the original page for complete details.

Connect your assistant

Use this production endpoint in an MCP-compatible client:

https://www.fishermans-lodge.com/api/catalogue/mcp

Transport: Streamable HTTP. Authentication: none. The public catalogue is available without an account.

  1. Add a remote MCP connection in your client. In ChatGPT, this requires an account with Developer Mode and custom MCP connections available.
  2. Enter the endpoint above, choose no authentication, and scan the tools. You should see four offer tools plus search_fish_guides and get_fish_guide.
  3. Enable the connection in your conversation, then ask it to find offers or answer a question about a fish species.

OpenAI’s current ChatGPT connection instructions

Opening the endpoint directly in a browser may return “Method not allowed” (HTTP 405). A browser GET request does not perform an MCP connection; use an MCP client.

Six read-only tools

search_offers
Search published offers and return structured facts, official images, starting rates with their billing units, and original website links.
get_offer
Retrieve one offer using the exact id from search_offers and an optional locale. A null result means the offer is not in the current public catalogue.
check_offer_availability
Check one selected offer for exact dates. The result is advisory, and the website checks availability again before an enquiry or booking request is submitted.
present_offers
Present one to six selected offers as official image cards with localized buttons to view details, select dates or send an enquiry on FISHERMANS-LODGE.
search_fish_guides
Search all published fish-species guides by localized common name, Latin name or fish key and return the official guide links.
get_fish_guide
Retrieve one localized guide with monthly activity, peak months, methods, habitat, diet, growth and country-specific fishing regions.
search_fishing_permits
Finds Finnish fishing areas by water, place or region and returns brief sourced facts with an FL guide link. A match does not confirm permission to fish.
get_fishing_permit
Returns important notes, unknowns, dated reference prices and relevant offer IDs. Complete conditions are on the FL page and official provider site; the tool cannot buy or issue a permit.

Supported search inputs

category
accommodations · activities · equipment · fullservice
locale · country
locale: de, en, fi or sv (default en). country: FI or SE. Missing translations can fall back to English; responses identify the text languages.
query · region · fishSpecies
query matches words in bounded localized excerpts. region is an exact province id or Finland map-region id. fishSpecies uses stored keys such as pike, perch or zander_pike_perch.
guests · boatAvailable
guests: 1–100. boatAvailable: true or false. Unknown capacity or location does not match a corresponding filter. An available boat is not necessarily included in the price.
priceUnit · minStartingPriceEur · maxStartingPriceEur
Starting-price bounds require one comparable billing unit. They are not a total-trip budget or a quote for particular dates and guests.
limit · offset
limit: 1–20 (default 10). offset: 0–10,000 (default 0). Follow nextOffset for the next page; response size limits can return fewer offers than requested.

Example inputs for search_offers

{
  "locale": "en",
  "category": "accommodations",
  "fishSpecies": "pike",
  "guests": 4,
  "boatAvailable": true,
  "priceUnit": "night",
  "maxStartingPriceEur": 250,
  "limit": 5
}

What the catalogue can tell you

  • Search does not bulk-filter offers by dates. Accommodation and equipment results can include a fresh rolling-horizon summary; check_offer_availability checks the user's exact dates for one selected offer at a time.
  • Prices are starting rates with explicit billing units, not a total trip price or a date-specific quote. Compare units before comparing amounts.
  • Descriptions and feature lists are excerpts. Missing facts remain unknown. Check the original listing for complete details, dates and booking options.
  • Fish-guide season and region information is editorial guidance. Fishing rules can change; always check current official and local regulations before fishing.
  • These tools cannot create bookings, enquiries, reservations or payments, or access customer information.

Information for agents and developers

These public resources describe the website and its MCP connection:

  • llms.txt — a short website and catalogue guide
  • MCP endpoint — the Streamable HTTP protocol endpoint for compatible clients

These links make the catalogue easier to find and understand. They do not automatically attach the MCP server to a chatbot or mean that it is already published in a plugin directory.

Explore on the website

You can also browse offers and guides directly, including when your assistant has no MCP connection.