Akkilahdot travel search

Etsi äkkilähtöjä ja pakettimatkoja Suomesta

search_holidays

Read-only

API hakuun suurimmasta ja kattavimmasta tietokannasta Suomessa pakettimatkojen tarjouksista. API:ta käytetään antamaan parhaat tarjoukset pakettimatkoista, jotka tarjoavat Tjäreborg, TUI, Apollo, Nazar, Ticket ja monet muut. Etsi parhaat saatavilla olevat pakettimatkat Suomesta hakukriteerien perusteella.

Input Schema

TableJSON Schema

Name	Required	Description
`lat`	No	Leveysasteikko desimaaliluvuissa, käytetään lon ja säteen kanssa
`lon`	No	Pituusasteikko desimaaliluvuissa, käytetään lat ja säteen kanssa
`bbox`	No	Maantieteellinen haku rajoitettu suorakulmiolla. Muoto: minLat,minLon,maxLat,maxLon.
`sort`	No	Tarjousten järjestys. Oletus on price_asc
`limit`	No	Tarjottavien määrä, esimerkiksi 5, 10. Oletus 1
`adults`	No	Aikuisten määrä 12-99 vuotta, oletus 2
`fields`	No	Kentät, jotka on sisällytettävä hakutuloksiin
`radius`	No	Säde kilometreinä lat, lon
`rating`	No	Vähimmäismäärä tähtiä, esimerkiksi 3, 4, 5
`infants`	No	Vauvojen määrä 0-1 vuotta, oletus 0
`category`	No	Loman kategoria SUNBATH=Aurinko ja uiminen, CITY=Kaupunkiloma, SKI=Hiihtoloma, EXOTIC=Eksoottinen
`children`	No	Lasten määrä 2-11 vuotta, oletus 0
`days_max`	No	Maksimimäärä päiviä lomalle, esimerkiksi 3, 7, 14
`days_min`	No	Vähimmäismäärä päiviä lomalle, esimerkiksi 3, 7, 14
`features`	No	Hotellin mukavuudet: ac=ilmastointi, adultsonly=Vain aikuisille, apartment=huoneisto, bar=baari, childspool=lastenallas, gym=kuntosali, heatedpool=lämmitetty uima-allas, kidsclub=lastenkerho, pool=uima-allas, seaview=merinäköala, restaurant=ravintola, spa=kylpylä
`max_price`	No	Maksimihinta koko matkalle, esimerkiksi 5000, 10000, 15000
`board_type`	No	Ateriat sisältyvät hotelliin, esimerkiksi aamiainen, puolihoito, täysihoito, all inclusive
`hotel_name`	No	Hotellin nimi, esimerkiksi Riu Palace, Iberostar, Sol
`temp_water`	No	Vähimmäisodotettu veden lämpötila Celsius-asteina, esimerkiksi 20, 25
`country_iso`	No	ISO-koodi maa, esimerkiksi ES, GR, PL, TR
`guest_rating`	No	Vähimmäisarvio, esimerkiksi 8.2, 9.0. Mediaani: 8.4
`direct_flight`	No	Aseta true löytääksesi hotelleja suorilla lennoilla
`distance_beach`	No	Maksimaalinen etäisyys rannalle metreinä, esimerkiksi 0, 100, 500
`depart_date_max`	No	Viimeisin mahdollinen loma-ajan alkamispäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
`depart_date_min`	No	Aikaisin mahdollinen loma-ajan alkamispäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
`distance_centre`	No	Maksimaalinen etäisyys keskustaan metreinä, esimerkiksi 0, 100, 500
`return_date_max`	No	Viimeisin mahdollinen kotiinpaluupäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
`return_date_min`	No	Aikaisin mahdollinen kotiinpaluupäivä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
`destination_name`	No	Kohdenimi, esimerkiksi Malta, Magaluf, Gran Canaria
`distance_airport`	No	Maksimaalinen etäisyys hotellin ja lentokentän välillä km, esimerkiksi 20, 40, 80
`number_of_nights`	No	Tarkka määrä öitä lomalle, esimerkiksi 3, 7, 14
`temp_air_day_max`	No	Maksimiodotettu päivälämpötila Celsius-asteina, esimerkiksi 25, 30
`temp_air_day_min`	No	Vähimmäisodotettu päivälämpötila Celsius-asteina, esimerkiksi 20, 25
`depart_date_exact`	No	Loman on alkaa tänä päivänä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
`return_date_exact`	No	Kotiinpaluupäivä alkaa tänä päivänä (ISO 8601 format YYYY-MM-DDTHH:MM:SSZ)
`origin_airport_code`	No	IATA-koodi lähtöpaikalle, esimerkiksi HEL, OUL, TLL
`destination_airport_code`	No	IATA-koodi määränpää lentokentälle, esimerkiksi ALC, AGP, TFS

TDQS

A3.5/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and destructiveHint=false, and the description's search language is consistent with that. The description adds context about database scope and suppliers but does not disclose behavior such as result size, pagination, or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is short but somewhat repetitive, repeating 'parhaat' and 'pakettimatkat' across three sentences. Each sentence contributes some information, but tighter wording would improve clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 37 optional parameters and no output schema, the description is adequate but minimal. It does not mention that no parameters are required or what a default search returns, though schema defaults partially cover this.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 37 parameters are already documented in the schema. The tool description does not add parameter meaning, but it does not need to because the schema carries the full burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific action ('Etsi' / search) and a resource ('pakettimatkoja' / package holidays) from Finland, naming major suppliers. The package-holiday focus inherently differentiates it from the sibling search_flights.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The intended usage for package-holiday searches from Finland is implied by the description, but there is no explicit guidance about when to prefer this tool over search_flights or when not to use it. No alternatives or exclusions are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Akkilahdot travel search tools Inspect

Try in Browser

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.8/5.0

Disambiguation5/5

The two tools are clearly distinct: one searches for flights and the other for package holidays. There is no overlap in their purposes or expected results.

Naming Consistency5/5

Both tool names follow the exact same verb_noun pattern: search_flights and search_holidays. The convention is consistent and predictable.

Tool Count3/5

With only two tools, the server feels minimal for a travel search domain. However, the two tools cover the main advertised search types, making the count borderline but not unreasonable.

Completeness4/5

The server focuses on search and provides the two primary search modes (flights and package holidays). It lacks hotel-only or rental car search, but for the stated purpose of finding flights and holiday packages, the surface is largely complete.

Resources

Need Help?