Avanza MCP Server

Overview Schema Source Related Servers Discussions Admin

list_futures_forwards

Read-onlyIdempotent

Retrieve futures and forwards with server-side pagination and ISO YYYY-MM-DD end date filtering. Supports sorting, option types, and underlying instruments.

Instructions

Select futures/forwards with server-side pagination and ISO YYYY-MM-DD end dates.

Use get_future_forward_filter_options for current filter vocabulary. The Matrix results include recognized contract, option, filter, and pagination fields.

Input Schema

TableJSON Schema

Name	Required	Default
`limit`	No
`offset`	No
`end_dates`	No
`sort_field`	No	strikePrice
`sort_order`	No	desc
`option_types`	No
`underlying_instruments`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`filter`	No
`sortBy`	No
`pagination`	No
`filterOptions`	No
`futureForwards`	No
`matchedOptions`	No
`underlyingInstrument`	No
`totalNumberOfOrderbooks`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed10 schema fields changedv2.1.0Sep 29, 2026

addedOutput schema / $defs

Added value: +{
+  "FilterOption": {
+    "description": "Named filter option, optionally containing child options.",
+    "properties": {
+      "children": {
+        "anyOf": [
+          {
+            "items": {
+              "$ref": "#/$defs/FilterOption"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "displayName": {
+        "type": "string"
+      },
+      "numberOfOrderbooks": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      },
+      "value": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "value",
+      "displayName",
+      "numberOfOrderbooks"
+    ],
+    "type": "object"
+  },
+  "FutureForwardFilterOptions": {
+    "properties": {
+      "callIndicators": {
+        "items": {
+          "$ref": "#/$defs/FilterOption"
+        },
+        "type": "array"
+      },
+      "endDates": {
+        "items": {
+          "$ref": "#/$defs/FilterOption"
+        },
+        "type": "array"
+      },
+      "optionTypes": {
+        "items": {
+          "$ref": "#/$defs/FilterOption"
+        },
+        "type": "array"
+      },
+      "underlyingInstruments": {
+        "items": {
+          "$ref": "#/$defs/FilterOption"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  "FutureForwardListItem": {
+    "properties": {
+      "buyPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "change": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "changePercent": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "countryCode": {
+        "type": "string"
+      },
+      "endDate": {
+        "type": "string"
+      },
+      "hasPosition": {
+        "type": "boolean"
+      },
+      "highestPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "lastPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "lowestPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "name": {
+        "type": "string"
+      },
+      "orderbookId": {
+        "type": "string"
+      },
+      "sellPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "totalVolumeTraded": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      }
+    },
+    "required": [
+      "orderbookId",
+      "countryCode",
+      "name",
+      "endDate",
+      "hasPosition"
+    ],
+    "type": "object"
+  },
+  "FutureForwardOptionLeg": {
+    "properties": {
+      "buyPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "buyVolume": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "callIndicator": {
+        "type": "string"
+      },
+      "countryCode": {
+        "type": "string"
+      },
+      "hasPosition": {
+        "type": "boolean"
+      },
+      "name": {
+        "type": "string"
+      },
+      "orderbookId": {
+        "type": "string"
+      },
+      "sellPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "sellVolume": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "strikePrice": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "orderbookId",
+      "countryCode",
+      "name",
+      "hasPosition",
+      "strikePrice",
+      "callIndicator"
+    ],
+    "type": "object"
+  },
+  "FutureForwardResponseFilter": {
+    "properties": {
+      "callIndicators": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "endDates": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "optionTypes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "underlyingInstruments": {
+        "items": {
+          "description": "Avanza order-book ID from discovery; not the separate instrumentId.",
+          "minLength": 1,
+          "pattern": "^[0-9]+$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "yearMonths": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  "FutureForwardUnderlyingOption": {
+    "properties": {
+      "change": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "changePercent": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "countryCode": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "highestPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "instrumentType": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "lastPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "lowestPrice": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "orderbookId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      }
+    },
+    "type": "object"
+  },
+  "MatchedOption": {
+    "properties": {
+      "call": {
+        "anyOf": [
+          {
+            "$ref": "#/$defs/FutureForwardOptionLeg"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "put": {
+        "anyOf": [
+          {
+            "$ref": "#/$defs/FutureForwardOptionLeg"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      }
+    },
+    "type": "object"
+  },
+  "PaginationResponse": {
+    "description": "Pagination values returned by filter endpoints.",
+    "properties": {
+      "limit": {
+        "type": "integer"
+      },
+      "offset": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "offset",
+      "limit"
+    ],
+    "type": "object"
+  },
+  "SortBy": {
+    "description": "Sort configuration for filter endpoints.",
+    "properties": {
+      "field": {
+        "type": "string"
+      },
+      "order": {
+        "enum": [
+          "asc",
+          "desc"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "field",
+      "order"
+    ],
+    "type": "object"
+  }
+}

removedOutput schema / additionalProperties
```
Removed value: -true
```

addedOutput schema / properties / filter

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/FutureForwardResponseFilter"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / filterOptions

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/FutureForwardFilterOptions"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / futureForwards

Added value: +{
+  "items": {
+    "$ref": "#/$defs/FutureForwardListItem"
+  },
+  "type": "array"
+}

addedOutput schema / properties / matchedOptions

Added value: +{
+  "items": {
+    "$ref": "#/$defs/MatchedOption"
+  },
+  "type": "array"
+}

addedOutput schema / properties / pagination

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/PaginationResponse"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / sortBy

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/SortBy"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / totalNumberOfOrderbooks

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / underlyingInstrument

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/FutureForwardUnderlyingOption"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Addedv2.0.0Sep 15, 2026

TDQS

B3.1/5.0

Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint and destructiveHint=false, so the safety profile is covered. The description adds pagination behavior (server-side) and the accepted end-date format, which is genuine added context, but says nothing about result volume, defaults, or how the recognized-fields filtering behaves.

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

Conciseness4/5

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

Two short sentences, front-loaded with the core action and scope. The trailing sentence about "Matrix results including recognized contract, option, filter, and pagination fields" is somewhat jargon-heavy, but nothing is padded.

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

Completeness2/5

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

An output schema exists, so return values need no explanation. But for a 7-parameter filtering tool with zero schema descriptions, the description omits how the filters, sort options, and pagination actually work, leaving the agent under-equipped to invoke it correctly despite the pointer to the filter-options helper.

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

Parameters2/5

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

Schema description coverage is 0% across 7 parameters, so the description must compensate and largely does not. It only clarifies the end_dates format; limit, offset, sort_field, sort_order, option_types and underlying_instruments (including the order-book ID caveat) are left entirely to the schema.

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

Purpose4/5

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

States a specific verb and resource ("Select futures/forwards") and adds scope details (server-side pagination, ISO end dates). It does not explicitly distinguish itself from sibling readers like get_future_forward_info or get_future_forward_details, but the listing/pagination framing is clear enough to route correctly.

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?

Points to get_future_forward_filter_options for the current filter vocabulary, which is a useful routing hint. However, it never says when to use this tool versus get_future_forward_info/details, nor any exclusion criteria. Usage is only implied.

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