catalog
Price comparison for Microsoft Flight Simulator add-ons: search, deals, per-store prices, history.
Should I use this
Quality & Safety
Findings (1)
- LOWin fetch
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"catalog": {
"url": "https://mcp.fsaircraft.net/mcp"
}
}
}Remote endpoints
https://mcp.fsaircraft.net/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢search_addons(q, category, sim, store, max_price_eur, ...)
Search the fsaircraft.net catalog of payware Microsoft Flight Simulator add-ons (aircraft, scenery, liveries, utilities) across every tracked store. Returns the cheapest live offer for each add-on with its discount and MSFS 2020/2024 compatibility as declared by the selling store.
Input Schema
{
"type": "object",
"properties": {
"q": {
"description": "Free text: title, developer, ICAO code or aircraft type",
"type": "string",
"maxLength": 120
},
"category": {
"description": "Category slug, e.g. 'aircraft', 'scenery', 'livery', 'utility'",
"type": "string"
},
"sim": {
"description": "Only add-ons declared compatible with this simulator",
"type": "string",
"enum": [
"msfs2020",
"msfs2024"
]
},
"store": {
"description": "Store slug, e.g. 'simmarket' — see list_stores",
"type": "string"
},
"max_price_eur": {
"description": "Inclusive ceiling on the known VAT-excluded price, in euros",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000
},
"on_sale": {
"description": "Only add-ons currently below their recorded high",
"type": "boolean"
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"developer": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"sims": {
"type": "array",
"items": {
"type": "string"
}
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cheapest live offer, minor units of `currency`"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Same price converted to EUR at ECB rates"
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded, where the store VAT rate is known"
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"store": {
"type": [
"string",
"null"
]
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"offer_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rating": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"developer",
"category",
"sims",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"tax_status",
"store",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"offer_count",
"rating",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"count",
"results"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_addon(slug)
Everything the catalog holds on a single add-on: description, developer, declared simulator compatibility, rating, every store offer with its VAT split and sale expiry, the lowest price ever recorded, and the real-world aircraft types and airports it implements.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Add-on slug, as it appears in https://fsaircraft.net/addons/{slug}"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"addon": {
"anyOf": [
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"developer": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"sims": {
"type": "array",
"items": {
"type": "string"
}
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cheapest live offer, minor units of `currency`"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Same price converted to EUR at ECB rates"
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded, where the store VAT rate is known"
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"store": {
"type": [
"string",
"null"
]
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"offer_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rating": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"string",
"null"
]
},
"released_at": {
"type": [
"string",
"null"
]
},
"rating_count": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"first_seen_at": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"aircraft_types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"icao_designator": {
"type": "string"
},
"manufacturer": {
"type": "string"
},
"model": {
"type": "string"
}
},
"required": [
"icao_designator",
"manufacturer",
"model"
],
"additionalProperties": false
}
},
"airports": {
"type": "array",
"items": {
"type": "object",
"properties": {
"icao": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": [
"string",
"null"
]
}
},
"required": [
"icao",
"name",
"country"
],
"additionalProperties": false
}
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"store": {
"type": "string"
},
"store_slug": {
"type": "string"
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded and EUR-converted: the only figure that compares across stores"
},
"vat_percent": {
"type": [
"number",
"null"
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"in_stock": {
"type": "boolean"
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"price_low_30d_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"last_seen_at": {
"type": "string"
},
"store_url": {
"type": "string"
},
"deep_link": {
"type": "string"
}
},
"required": [
"store",
"store_slug",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"vat_percent",
"tax_status",
"in_stock",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"price_low_30d_cents",
"last_seen_at",
"store_url",
"deep_link"
],
"additionalProperties": false
}
},
"price_low_all_time_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"is_lowest_ever": {
"type": "boolean"
},
"also_listed_as": {
"type": "array",
"items": {
"type": "string"
},
"description": "Other slugs merged into this add-on by cross-store dedupe"
}
},
"required": [
"slug",
"title",
"developer",
"category",
"sims",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"tax_status",
"store",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"offer_count",
"rating",
"url",
"description",
"summary",
"version",
"released_at",
"rating_count",
"first_seen_at",
"image_url",
"aircraft_types",
"airports",
"offers",
"price_low_all_time_cents",
"is_lowest_ever",
"also_listed_as"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"as_of",
"found",
"addon"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_deals(category, sim, ending_within_days, limit)
Add-ons discounted right now, deepest discount first. A discount here means the current price is below the highest price we have ever recorded for that same offer at that same store — never a store-printed list price, so permanent markdowns do not appear.
Input Schema
{
"type": "object",
"properties": {
"category": {
"type": "string"
},
"sim": {
"type": "string",
"enum": [
"msfs2020",
"msfs2024"
]
},
"ending_within_days": {
"description": "Only sales with a published end date inside N days",
"type": "integer",
"minimum": 1,
"maximum": 60
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"developer": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"sims": {
"type": "array",
"items": {
"type": "string"
}
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cheapest live offer, minor units of `currency`"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Same price converted to EUR at ECB rates"
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded, where the store VAT rate is known"
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"store": {
"type": [
"string",
"null"
]
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"offer_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rating": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"developer",
"category",
"sims",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"tax_status",
"store",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"offer_count",
"rating",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"count",
"results"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢compare_prices(slug)
Every store offer for one add-on, in-stock offers with known net prices first, ordered by net EUR price. Includes the listed price, tax status, known net price, EUR conversion, stock, sale expiry and an outbound link.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string"
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"store": {
"type": "string"
},
"store_slug": {
"type": "string"
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded and EUR-converted: the only figure that compares across stores"
},
"vat_percent": {
"type": [
"number",
"null"
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"in_stock": {
"type": "boolean"
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"price_low_30d_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"last_seen_at": {
"type": "string"
},
"store_url": {
"type": "string"
},
"deep_link": {
"type": "string"
}
},
"required": [
"store",
"store_slug",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"vat_percent",
"tax_status",
"in_stock",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"price_low_30d_cents",
"last_seen_at",
"store_url",
"deep_link"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"slug",
"title",
"url",
"count",
"offers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢price_history(slug, days)
Daily lowest known VAT-excluded price in EUR, using current exchange rates, plus min/max/current and whether it is at its lowest ever. Answers "has this ever been cheaper than X?".
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"days": {
"default": 180,
"type": "integer",
"minimum": 1,
"maximum": 365
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"days": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"price_basis": {
"type": "string",
"const": "net"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"price_cents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string"
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"date",
"price_cents",
"currency",
"price_eur_cents"
],
"additionalProperties": false
}
},
"min_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"max_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"current_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"is_lowest_ever": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"as_of",
"slug",
"days",
"price_basis",
"points",
"min_eur_cents",
"max_eur_cents",
"current_eur_cents",
"is_lowest_ever",
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_stores
Every storefront in the catalog, with how many add-ons we track there, how many are discounted right now, and whether its prices include VAT. Use it to answer "which stores do you actually cover" and to get the `store` slug vocabulary for search_addons.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"stores": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"base_url": {
"type": "string"
},
"product_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"offer_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"on_sale_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"prices_include_vat": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"slug",
"name",
"base_url",
"product_count",
"offer_count",
"on_sale_count",
"prices_include_vat"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"count",
"stores"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_developers(q, limit)
Add-on studios in the catalog, busiest first, optionally filtered by name.
Input Schema
{
"type": "object",
"properties": {
"q": {
"description": "Substring of the developer name",
"type": "string",
"maxLength": 80
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"developers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"website": {
"type": [
"string",
"null"
]
},
"product_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"website",
"product_count",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"count",
"developers"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_aircraft_type(q, limit)
Resolve a plain-language aircraft name ("737 MAX", "Cessna 172", "A320neo") to its ICAO Doc 8643 designator, with how many add-ons we carry for it. Feed the designator to list_addons_for_aircraft.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"description": "Designator, model, family or manufacturer"
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"q"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"icao_designator": {
"type": "string"
},
"manufacturer": {
"type": "string"
},
"model": {
"type": "string"
},
"family": {
"type": [
"string",
"null"
]
},
"category": {
"type": "string"
},
"addon_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"url": {
"type": "string"
}
},
"required": [
"icao_designator",
"manufacturer",
"model",
"family",
"category",
"addon_count",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"count",
"types"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_addons_for_aircraft(icao_designator, sim, limit)
Every add-on implementing one real-world aircraft type, across all studios, cheapest first. The type link is our own classification (from the title and the store metadata), not the store's.
Input Schema
{
"type": "object",
"properties": {
"icao_designator": {
"type": "string",
"minLength": 2,
"maxLength": 4,
"description": "ICAO Doc 8643 designator, e.g. 'B738', 'A20N', 'C172'"
},
"sim": {
"type": "string",
"enum": [
"msfs2020",
"msfs2024"
]
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"icao_designator"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"icao_designator": {
"type": "string"
},
"type": {
"anyOf": [
{
"type": "object",
"properties": {
"icao_designator": {
"type": "string"
},
"manufacturer": {
"type": "string"
},
"model": {
"type": "string"
},
"family": {
"type": [
"string",
"null"
]
},
"category": {
"type": "string"
},
"addon_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"url": {
"type": "string"
}
},
"required": [
"icao_designator",
"manufacturer",
"model",
"family",
"category",
"addon_count",
"url"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"developer": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"sims": {
"type": "array",
"items": {
"type": "string"
}
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cheapest live offer, minor units of `currency`"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Same price converted to EUR at ECB rates"
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded, where the store VAT rate is known"
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"store": {
"type": [
"string",
"null"
]
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"offer_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rating": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"developer",
"category",
"sims",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"tax_status",
"store",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"offer_count",
"rating",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"icao_designator",
"type",
"count",
"results"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_sceneries_for_airport(icao, sim, limit)
Every add-on scenery we carry for one airport, by ICAO (or IATA) code, cheapest first.
Input Schema
{
"type": "object",
"properties": {
"icao": {
"type": "string",
"minLength": 3,
"maxLength": 4,
"description": "ICAO code, e.g. 'EGLL', 'KJFK'. IATA also accepted."
},
"sim": {
"type": "string",
"enum": [
"msfs2020",
"msfs2024"
]
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"icao"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"icao": {
"type": "string"
},
"airport": {
"anyOf": [
{
"type": "object",
"properties": {
"icao": {
"type": "string"
},
"iata": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"city": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"icao",
"iata",
"name",
"city",
"country",
"url"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"developer": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"sims": {
"type": "array",
"items": {
"type": "string"
}
},
"price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cheapest live offer, minor units of `currency`"
},
"currency": {
"type": [
"string",
"null"
]
},
"price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Same price converted to EUR at ECB rates"
},
"net_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "VAT-excluded, where the store VAT rate is known"
},
"net_price_eur_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"tax_status": {
"type": "string",
"enum": [
"included",
"excluded",
"unknown"
]
},
"store": {
"type": [
"string",
"null"
]
},
"discount_pct": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"was_price_cents": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"sale_ends_at": {
"type": [
"string",
"null"
]
},
"offer_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rating": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"developer",
"category",
"sims",
"price_cents",
"currency",
"price_eur_cents",
"net_price_cents",
"net_price_eur_cents",
"tax_status",
"store",
"discount_pct",
"was_price_cents",
"sale_ends_at",
"offer_count",
"rating",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"icao",
"airport",
"count",
"results"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search(query)
Search the fsaircraft.net MSFS add-on catalog and return documents in the shape ChatGPT deep-research and company-knowledge connectors expect. `id` is the add-on slug; pass it to `fetch`. Prefer search_addons when filters or prices matter.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 200
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"title",
"text",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢fetch(id)
Retrieve one add-on as a document, by the `id` returned from `search` (the add-on slug). Returns the full description plus every current store price.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string"
},
"url": {
"type": "string"
},
"metadata": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence