Amadeus MCP Server
by privilegemendes
Verified
- amadeus-mcp-server-standalone
- api-spectifications
{
"swagger": "2.0",
"info": {
"version": "1.1.2",
"title": "Airport Nearest Relevant",
"x-tags": [
"#ama-for-dev"
],
"x-status": "validated",
"x-release-note": {
"1.1.1": [
"Correct example"
],
"1.1.0": [
"Add radius parameter"
],
"1.0.2": [
"AFD-1091 - change from \"traveller\" to \"traveler\""
],
"1.0.1": [
"Improvement of relevance calculation",
"Remove flights and travelers figures",
"Flights and Travelers score become integer (PTR 14827552)"
],
"1.0": [
"Initial Version"
]
},
"description": "\nBefore using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token.\n\nPlease also be aware that our test environment is based on a subset of the production, this API in test only returns a few selected cities. You can find the list in our **[data collection](https://github.com/amadeus4dev/data-collection)**."
},
"host": "test.api.amadeus.com",
"basePath": "/v1",
"schemes": [
"https"
],
"consumes": [
"application/vnd.amadeus+json"
],
"produces": [
"application/vnd.amadeus+json"
],
"paths": {
"/reference-data/locations/airports": {
"get": {
"tags": [
"location"
],
"operationId": "getNearestRelevantAirports",
"summary": "Returns a list of relevant airports near to a given point.",
"parameters": [
{
"name": "latitude",
"description": "latitude location to be at the center of the search circle",
"in": "query",
"required": true,
"type": "number",
"format": "double",
"x-example": 51.57285
},
{
"name": "longitude",
"description": "longitude location to be at the center of the search circle",
"in": "query",
"required": true,
"type": "number",
"format": "double",
"x-example": -0.44161
},
{
"name": "radius",
"description": "radius of the search in Kilometer. Can be from 0 to 500, default value is 500 Km.",
"in": "query",
"required": false,
"type": "integer",
"minimum": 0,
"maximum": 500,
"default": 500
},
{
"$ref": "#/parameters/pageLimit"
},
{
"$ref": "#/parameters/pageOffset"
},
{
"$ref": "#/parameters/sort"
}
],
"responses": {
"200": {
"$ref": "#/responses/nearest-relevant-airports"
},
"400": {
"$ref": "#/responses/400"
},
"default": {
"$ref": "#/responses/500"
}
},
"description": ""
}
}
},
"parameters": {
"pageLimit": {
"name": "page[limit]",
"description": "maximum items in one page",
"required": false,
"in": "query",
"type": "integer",
"default": 10
},
"pageOffset": {
"name": "page[offset]",
"description": "start index of the requested page",
"required": false,
"in": "query",
"type": "integer",
"default": 0
},
"sort": {
"description": "defines on which attribute the sorting will be done from the best option to the worst one:\n* **relevance** - Score value calculated based on distance and traffic analytics\n* **distance** - Distance from the location to the geo-code given in API request parameters\n* **analytics.flights.score** - Approximate score for ranking purposes calculated based on estimated number of flights from/to airport in one reference year (last year)\n* **analytics.travelers.score** - Approximate score for ranking purposes calculated based on estimated number of travelers in the airport for one reference year (last year)\n",
"name": "sort",
"required": false,
"in": "query",
"type": "string",
"default": "relevance",
"enum": [
"relevance",
"distance",
"analytics.flights.score",
"analytics.travelers.score"
]
}
},
"definitions": {
"Location": {
"properties": {
"type": {
"description": "the resource name",
"type": "string",
"example": "location"
},
"subType": {
"description": "location sub type",
"type": "string",
"enum": [
"AIRPORT",
"CITY",
"POINT_OF_INTEREST",
"DISTRICT"
],
"example": "AIRPORT"
},
"name": {
"description": "short name of the location",
"type": "string",
"example": "Paris CDG"
},
"detailedName": {
"description": "detailed name of the location. For a city location it contains city name and country code. For an airport location it contains city name; country code and airport full name",
"type": "string",
"example": "Paris/FR: Charles de Gaulle"
},
"timeZoneOffset": {
"description": "timezone offset of the location at the date of the API call (including daylight saving time)",
"type": "string",
"example": "+01:00"
},
"iataCode": {
"description": "IATA code of the location. ([IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) here)",
"type": "string",
"example": "CDG"
},
"geoCode": {
"$ref": "#/definitions/GeoCode"
},
"address": {
"$ref": "#/definitions/Address"
},
"distance": {
"$ref": "#/definitions/Distance"
},
"analytics": {
"$ref": "#/definitions/Analytics"
},
"relevance": {
"type": "number",
"format": "double",
"description": "score value calculated based on distance and analytics",
"example": 9.6584
}
}
},
"Address": {
"properties": {
"cityName": {
"description": "name of the city of the location; equal to name if the location is a city",
"type": "string",
"example": "Paris"
},
"cityCode": {
"description": "IATA code of the city of the location; equal to IATAcode if the location is a city",
"type": "string",
"example": "PAR"
},
"countryName": {
"description": "name of the country of the location",
"type": "string",
"example": "France"
},
"countryCode": {
"description": "code of the country of the location in ISO standard",
"type": "string",
"example": "FR"
},
"stateCode": {
"description": "code of the state of the location if any",
"type": "string",
"example": "TO"
},
"regionCode": {
"description": "code of the region of the location in ISO standard",
"type": "string",
"example": "EUROP"
}
}
},
"Distance": {
"properties": {
"value": {
"description": "great-circle distance between two locations. This distance thus do not take into account traffic conditions; international boundaries; mountains; water; or other elements that might make the a nearby location hard to reach.",
"type": "integer",
"example": 152
},
"unit": {
"description": "unit of the distance",
"type": "string",
"example": "KM",
"enum": [
"KM",
"MI"
]
}
}
},
"GeoCode": {
"properties": {
"latitude": {
"description": "latitude of the location",
"type": "number",
"format": "double",
"example": 43.580418
},
"longitude": {
"description": "longitude of the location",
"type": "number",
"format": "double",
"example": 7.125102
}
}
},
"Analytics": {
"properties": {
"flights": {
"$ref": "#/definitions/Flights"
},
"travelers": {
"$ref": "#/definitions/Travelers"
}
}
},
"Flights": {
"properties": {
"score": {
"type": "number",
"format": "integer",
"description": "Approximate score for ranking purposes calculated based on number of flights from / to the airport or city",
"example": 56
}
}
},
"Travelers": {
"properties": {
"score": {
"type": "number",
"format": "integer",
"description": "Approximate score for ranking purposes calculated based on number of travelers in the location.",
"example": 68
}
}
},
"Error_400": {
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/definitions/Issue"
}
}
},
"required": [
"errors"
],
"example": {
"errors": [
{
"status": 400,
"code": 477,
"title": "INVALID FORMAT",
"detail": "invalid query parameter format",
"source": {
"parameter": "airport",
"example": "CDG"
}
}
]
}
},
"Error_500": {
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/definitions/Issue"
}
}
},
"required": [
"errors"
],
"example": {
"errors": [
{
"status": 500,
"code": 141,
"title": "SYSTEM ERROR HAS OCCURRED"
}
]
}
},
"Issue": {
"properties": {
"status": {
"description": "the HTTP status code applicable to this error",
"type": "integer"
},
"code": {
"description": "an application-specific error code",
"type": "integer",
"format": "int64"
},
"title": {
"description": "a short summary of the error",
"type": "string"
},
"detail": {
"description": "explanation of the error",
"type": "string"
},
"source": {
"type": "object",
"title": "Issue_Source",
"description": "an object containing references to the source of the error",
"maxProperties": 1,
"properties": {
"pointer": {
"description": "a JSON Pointer [RFC6901] to the associated entity in the request document",
"type": "string"
},
"parameter": {
"description": "a string indicating which URI query parameter caused the issue",
"type": "string"
},
"example": {
"description": "a string indicating an example of the right value",
"type": "string"
}
}
}
}
},
"Collection_Meta": {
"title": "Collection_Meta",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"links": {
"title": "CollectionLinks",
"properties": {
"self": {
"type": "string",
"format": "uri",
"example": "https://test.api.amadeus.com/v1/area/resources?..."
},
"next": {
"type": "string",
"format": "uri",
"example": "https://test.api.amadeus.com/v1/area/resources?..."
},
"previous": {
"type": "string",
"format": "uri",
"example": "https://test.api.amadeus.com/v1/area/resources?..."
},
"last": {
"type": "string",
"format": "uri",
"example": "https://test.api.amadeus.com/v1/area/resources?..."
},
"first": {
"type": "string",
"format": "uri",
"example": "https://test.api.amadeus.com/v1/area/resources?..."
},
"up": {
"type": "string",
"format": "uri",
"example": "https://test.api.amadeus.com/v1/area/resources?..."
}
},
"example": {
"self": "https://test.api.amadeus.com/v1/area/resources?param=value"
}
}
}
}
},
"responses": {
"400": {
"description": "code | title \n------- | ------------------------------------- \n477 | INVALID FORMAT\n572 | INVALID OPTION\n4926 | INVALID DATA RECEIVED \n32171 | MANDATORY DATA MISSING \t \n",
"schema": {
"$ref": "#/definitions/Error_400"
}
},
"500": {
"description": "Unexpected Error",
"schema": {
"$ref": "#/definitions/Error_500"
}
},
"nearest-relevant-airports": {
"description": "Successful Operation",
"schema": {
"title": "Success",
"required": [
"data"
],
"properties": {
"meta": {
"$ref": "#/definitions/Collection_Meta"
},
"data": {
"type": "array",
"items": {
"$ref": "#/definitions/Location"
}
}
},
"example": {
"meta": {
"count": 32,
"links": {
"self": "https://test.api.amadeus.com/v1/reference-data/locations/airports?latitude=51.57285&longitude=-0.44161",
"next": "https://test.api.amadeus.com/v1/reference-data/locations/airports?latitude=51.57285&longitude=-0.44161&page%5Boffset%5D=10",
"last": "https://test.api.amadeus.com/v1/reference-data/locations/airports?latitude=51.57285&longitude=-0.44161&page%5Boffset%5D=22"
}
},
"data": [
{
"type": "location",
"subType": "AIRPORT",
"name": "HEATHROW",
"detailedName": "LONDON/GB:HEATHROW",
"timeZoneOffset": "+01:00",
"iataCode": "LHR",
"geoCode": {
"latitude": 51.47294,
"longitude": -0.45061
},
"address": {
"cityName": "LONDON",
"cityCode": "LON",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 11,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 39
},
"travelers": {
"score": 45
}
},
"relevance": 350.54587
},
{
"type": "location",
"subType": "AIRPORT",
"name": "GATWICK",
"detailedName": "LONDON/GB:GATWICK",
"timeZoneOffset": "+01:00",
"iataCode": "LGW",
"geoCode": {
"latitude": 51.15609,
"longitude": -0.17818
},
"address": {
"cityName": "LONDON",
"cityCode": "LON",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 49,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 27
},
"travelers": {
"score": 27
}
},
"relevance": 53.62667
},
{
"type": "location",
"subType": "AIRPORT",
"name": "LUTON",
"detailedName": "LONDON/GB:LUTON",
"timeZoneOffset": "+01:00",
"iataCode": "LTN",
"geoCode": {
"latitude": 51.87472,
"longitude": -0.36833
},
"address": {
"cityName": "LONDON",
"cityCode": "LON",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 33,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 11
},
"travelers": {
"score": 10
}
},
"relevance": 33.10184
},
{
"type": "location",
"subType": "AIRPORT",
"name": "STANSTED",
"detailedName": "LONDON/GB:STANSTED",
"timeZoneOffset": "+01:00",
"iataCode": "STN",
"geoCode": {
"latitude": 51.885,
"longitude": 0.235
},
"address": {
"cityName": "LONDON",
"cityCode": "LON",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 58,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 16
},
"travelers": {
"score": 15
}
},
"relevance": 27.50241
},
{
"type": "location",
"subType": "AIRPORT",
"name": "CITY AIRPORT",
"detailedName": "LONDON/GB:CITY AIRPORT",
"timeZoneOffset": "+01:00",
"iataCode": "LCY",
"geoCode": {
"latitude": 51.50528,
"longitude": 0.05528
},
"address": {
"cityName": "LONDON",
"cityCode": "LON",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 35,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 8
},
"travelers": {
"score": 4
}
},
"relevance": 21.78754
},
{
"type": "location",
"subType": "AIRPORT",
"name": "BIRMINGHAM",
"detailedName": "BIRMINGHAM/GB:BIRMINGHAM",
"timeZoneOffset": "+01:00",
"iataCode": "BHX",
"geoCode": {
"latitude": 52.45386,
"longitude": -1.74803
},
"address": {
"cityName": "BIRMINGHAM",
"cityCode": "BHX",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 132,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 10
},
"travelers": {
"score": 8
}
},
"relevance": 7.73356
},
{
"type": "location",
"subType": "AIRPORT",
"name": "MANCHESTER AIRPORT",
"detailedName": "MANCHESTER/GB:MANCHESTER AIRPO",
"timeZoneOffset": "+01:00",
"iataCode": "MAN",
"geoCode": {
"latitude": 53.35374,
"longitude": -2.27495
},
"address": {
"cityName": "MANCHESTER",
"cityCode": "MAN",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 233,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 18
},
"travelers": {
"score": 17
}
},
"relevance": 7.71084
},
{
"type": "location",
"subType": "AIRPORT",
"name": "SOUTHAMPTON",
"detailedName": "SOUTHAMPTON/GB",
"timeZoneOffset": "+01:00",
"iataCode": "SOU",
"geoCode": {
"latitude": 50.95026,
"longitude": -1.3568
},
"address": {
"cityName": "SOUTHAMPTON",
"cityCode": "SOU",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 94,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 4
},
"travelers": {
"score": 2
}
},
"relevance": 4.4788
},
{
"type": "location",
"subType": "AIRPORT",
"name": "BRISTOL",
"detailedName": "BRISTOL/GB:BRISTOL",
"timeZoneOffset": "+01:00",
"iataCode": "BRS",
"geoCode": {
"latitude": 51.38267,
"longitude": -2.71909
},
"address": {
"cityName": "BRISTOL",
"cityCode": "BRS",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 159,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 7
},
"travelers": {
"score": 5
}
},
"relevance": 4.08617
},
{
"type": "location",
"subType": "AIRPORT",
"name": "EAST MIDLANDS",
"detailedName": "NOTTINGHAM/GB:EAST MIDLANDS",
"timeZoneOffset": "+01:00",
"iataCode": "EMA",
"geoCode": {
"latitude": 52.83111,
"longitude": -1.32806
},
"address": {
"cityName": "NOTTINGHAM",
"cityCode": "NQT",
"countryName": "UNITED KINGDOM",
"countryCode": "GB",
"regionCode": "EUROP"
},
"distance": {
"value": 152,
"unit": "KM"
},
"analytics": {
"flights": {
"score": 4
},
"travelers": {
"score": 3
}
},
"relevance": 2.66099
}
]
}
}
}
},
"x-generatedAt": "2020-07-22T14:53:48.686Z"
}