Avanza MCP Server

Overview Schema Source Related Servers Discussions Admin

get_etf_details

Read-onlyIdempotent

Retrieve extended ETF details using an Avanza order-book ID to access flexible upstream-defined fields beyond standard info.

Instructions

Get extended ETF details beyond info. Detail fields are upstream-defined and flexible.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`order_book_id`	Yes	Avanza order-book ID from discovery; not the separate instrumentId.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`issuer`	No
`trades`	No
`esgView`	No
`category`	No
`dividends`	No
`documents`	No
`introDate`	No
`riskScore`	No
`orderDepth`	No
`description`	No
`tradingUnit`	No
`assetCategory`	No
`fundExposures`	No
`holdingPeriod`	No
`portfolioDate`	No
`collateralValue`	No
`sectorExposures`	No
`countryExposures`	No
`brokerTradeSummaries`	No
`superInterestApproved`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed21 schema fields changedv2.1.0Sep 29, 2026

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

addedOutput schema / properties / assetCategory

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

addedOutput schema / properties / brokerTradeSummaries

Added value: +{
+  "items": {
+    "description": "Summary of broker trades for a stock.",
+    "properties": {
+      "brokerCode": {
+        "type": "string"
+      },
+      "brokerName": {
+        "type": "string"
+      },
+      "buyVolume": {
+        "type": "integer"
+      },
+      "netBuyVolume": {
+        "type": "integer"
+      },
+      "sellVolume": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "brokerCode",
+      "sellVolume",
+      "buyVolume",
+      "netBuyVolume",
+      "brokerName"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / category

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

addedOutput schema / properties / collateralValue

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

addedOutput schema / properties / countryExposures

Added value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "exposures": {
+          "items": {
+            "properties": {
+              "countryCode": {
+                "type": "string"
+              },
+              "countryName": {
+                "type": "string"
+              },
+              "weight": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "countryCode",
+              "countryName",
+              "weight"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "updated": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "updated",
+        "exposures"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / description

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

addedOutput schema / properties / dividends

Added value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "events": {
+          "items": {
+            "properties": {
+              "amount": {
+                "type": "number"
+              },
+              "currencyCode": {
+                "type": "string"
+              },
+              "dividendType": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "exDate": {
+                "type": "string"
+              },
+              "exDateStatus": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "paymentDate": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "exDate",
+              "paymentDate",
+              "amount",
+              "currencyCode"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "pastEvents": {
+          "items": {
+            "properties": {
+              "amount": {
+                "type": "number"
+              },
+              "currencyCode": {
+                "type": "string"
+              },
+              "dividendType": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "exDate": {
+                "type": "string"
+              },
+              "exDateStatus": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "paymentDate": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "exDate",
+              "paymentDate",
+              "amount",
+              "currencyCode"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / documents

Added value: +{
+  "anyOf": [
+    {
+      "description": "Public instrument document links.",
+      "properties": {
+        "kid": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "prospectus": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / esgView

Added value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "euArticleType": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "sustainabilityDevelopmentGoals": {
+          "items": {
+            "description": "UN Sustainable Development Goal information.",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              },
+              "value": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "value",
+              "name",
+              "type",
+              "status"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / fundExposures

Added value: +{
+  "items": {
+    "properties": {
+      "countryCode": {
+        "type": "string"
+      },
+      "exposure": {
+        "type": "number"
+      },
+      "hasPosition": {
+        "type": "boolean"
+      },
+      "instrumentType": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "orderbookId": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "orderbookId",
+      "name",
+      "exposure",
+      "instrumentType",
+      "countryCode",
+      "hasPosition"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / holdingPeriod

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

addedOutput schema / properties / introDate

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

addedOutput schema / properties / issuer

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

addedOutput schema / properties / orderDepth

Added value: +{
+  "anyOf": [
+    {
+      "description": "Order book depth showing buy and sell orders.",
+      "properties": {
+        "levels": {
+          "default": [],
+          "items": {
+            "description": "Single level in the order book depth.",
+            "properties": {
+              "buySide": {
+                "anyOf": [
+                  {
+                    "description": "Buy or sell side of an order.",
+                    "properties": {
+                      "price": {
+                        "type": "number"
+                      },
+                      "priceString": {
+                        "type": "string"
+                      },
+                      "volume": {
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "price",
+                      "volume",
+                      "priceString"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "sellSide": {
+                "anyOf": [
+                  {
+                    "description": "Buy or sell side of an order.",
+                    "properties": {
+                      "price": {
+                        "type": "number"
+                      },
+                      "priceString": {
+                        "type": "string"
+                      },
+                      "volume": {
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "price",
+                      "volume",
+                      "priceString"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "receivedTime": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / portfolioDate

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

addedOutput schema / properties / riskScore

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

addedOutput schema / properties / sectorExposures

Added value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "exposures": {
+          "items": {
+            "properties": {
+              "sector": {
+                "type": "string"
+              },
+              "weight": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "sector",
+              "weight"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "updated": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "updated",
+        "exposures"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / properties / superInterestApproved

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

addedOutput schema / properties / trades

Added value: +{
+  "items": {
+    "description": "Individual trade information.",
+    "properties": {
+      "buyer": {
+        "type": "string"
+      },
+      "buyerName": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "cancelled": {
+        "type": "boolean"
+      },
+      "dealTime": {
+        "type": "integer"
+      },
+      "matchedOnMarket": {
+        "type": "boolean"
+      },
+      "price": {
+        "type": "number"
+      },
+      "seller": {
+        "type": "string"
+      },
+      "sellerName": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "volume": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "buyer",
+      "seller",
+      "dealTime",
+      "price",
+      "volume",
+      "matchedOnMarket",
+      "cancelled"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / tradingUnit

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

Addedv2.0.0Sep 15, 2026

TDQS

A3.8/5.0

Behavior4/5

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

Annotations declare read-only, idempotent, non-destructive, and open-world. The description adds that detail fields are 'upstream-defined and flexible', a useful behavioral trait about output variability that is not captured in annotations. It does not contradict annotations.

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

Conciseness5/5

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

Two short sentences with no wasted words. The purpose is front-loaded and the behavioral note follows efficiently. Highly concise.

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

Completeness4/5

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

With an output schema present and annotations covering safety, the description only needs to convey scope and any unique behavior. It does that by noting extended details and flexible fields, though it could be slightly more explicit about when to choose this over get_etf_info.

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 coverage is 100% and the single parameter order_book_id is well described in the schema (including a note about the separate instrumentId). The description adds no further parameter semantics, so baseline 3 applies.

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 ('Get') and resource ('ETF details'), and differentiates from sibling get_etf_info by noting it goes 'beyond info'. However, 'extended details' is somewhat vague about what specific data is returned, so not perfect.

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?

Implies usage when more detail than get_etf_info is needed, but does not explicitly state when to use this tool versus alternatives or any prerequisites. The reference to 'beyond info' provides some context but no clear exclusions.

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