Skip to main content
Glama

Read portfolio holdings

get_portfolio_holdings
Read-onlyIdempotent

Read whole-portfolio direct holdings or pooled fund look-through. The two views cover the same capital. Preserve currency, dates, coverage and denominators. Page with computed_at and restart on snapshot change. Missing snapshots return unavailable. Requires portfolio:read and portfolio detail entitlement.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_portfolio_holdings"
  }
}

Input Schema

NameRequiredDescriptionDefault
viewNoDirect holdings or pooled fund constituents; never add both views.look_through
limitNoMaximum rows per page; defaults to 20.
offsetNoRows to skip; use the returned nextOffset.
computed_atNoSnapshot timestamp from page one; keep it when paging.

Output Schema

NameRequiredDescriptionDefault
viewYes
itemsYes
scopeYes
totalYes
reasonYes
statusYes
omittedYes
snapshotYes
nextOffsetYes
definitionsYes
limitationsYes
lookThroughYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / computed_at / description
      Added value: +"Snapshot timestamp from page one; keep it when paging."
    • addedInput schema / properties / limit / description
      Added value: +"Maximum rows per page; defaults to 20."
    • addedInput schema / properties / offset / description
      Added value: +"Rows to skip; use the returned nextOffset."
    • addedInput schema / properties / view / description
      Added value: +"Direct holdings or pooled fund constituents; never add both views."
  2. Changed1 schema field changed
    • changedOutput schema / properties / lookThrough / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "coverage": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "opaqueInherent": {
      -            "type": "number"
      -          },
      -          "opaquePending": {
      -            "type": "number"
      -          },
      -          "transparent": {
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "transparent",
      -          "opaqueInherent",
      -          "opaquePending"
      -        ],
      -        "type": "object"
      -      },
      -      "dissolved": {
      -        "additionalProperties": false,
      -        "description": "How the funds this counter counts resolved: fully dissolved, partly dissolved, or not at all. Funds that can be looked through, which means funds that can hold stocks. A bond, cash (money market, overnight), gold or crypto fund is never counted here: it cannot hold a listed company, so it is never dissolved and is reported instead as an opaque sleeve, held as a whole, in its own asset class. An equity fund whose constituent fetch failed IS counted, under `none`: it is a fund that can be looked through and has not been, which is a gap rather than a rule.",
      -        "properties": {
      -          "full": {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          "none": {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          },
      -          "partial": {
      -            "maximum": 9007199254740991,
      -            "minimum": -9007199254740991,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "full",
      -          "partial",
      -          "none"
      -        ],
      -        "type": "object"
      -      },
      -      "etfCount": {
      -        "description": "Funds that can be looked through, which means funds that can hold stocks. A bond, cash (money market, overnight), gold or crypto fund is never counted here: it cannot hold a listed company, so it is never dissolved and is reported instead as an opaque sleeve, held as a whole, in its own asset class. A fund is an ISIN, not a holding row: one ETF held at two brokers counts once, and the overlap pairs are drawn from this same population.",
      -        "maximum": 9007199254740991,
      -        "minimum": -9007199254740991,
      -        "type": "integer"
      -      },
      -      "etfs": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "asOf": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "coveredWeight": {
      -              "type": "number"
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "status": {
      -              "enum": [
      -                "full",
      -                "partial",
      -                "none"
      -              ],
      -              "type": "string"
      -            },
      -            "ticker": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "ticker",
      -            "name",
      -            "status",
      -            "coveredWeight",
      -            "asOf"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 50,
      -        "type": "array"
      -      },
      -      "omittedFunds": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "omittedOpaqueSleeves": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "opaqueSleeves": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "assetClass": {
      -              "type": "string"
      -            },
      -            "kind": {
      -              "enum": [
      -                "inherent",
      -                "pending"
      -              ],
      -              "type": "string"
      -            },
      -            "name": {
      -              "type": "string"
      -            },
      -            "reason": {
      -              "description": "Serve-time localized text. The engine stores its reason key here; the serve layer replaces it with text in the caller's language.",
      -              "type": "string"
      -            },
      -            "reasonKey": {
      -              "description": "Language-free reason key. Absent on a payload cached before keys existed, whose `reason` then passes through as the German text the engine wrote (for example `Als Ganzes gehalten`), whatever the caller's language, until that payload is recomputed. `pending` covers two situations a caller may want to tell apart and today cannot: the constituent fetch failed on this run, and the provider returns no constituents for this wrapper at all, which no retry will change.",
      -              "enum": [
      -                "pending",
      -                "money-market",
      -                "bond-fund",
      -                "held-whole"
      -              ],
      -              "type": "string"
      -            },
      -            "ticker": {
      -              "type": "string"
      -            },
      -            "weight": {
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "ticker",
      -            "name",
      -            "weight",
      -            "kind",
      -            "reason",
      -            "assetClass"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 50,
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "etfCount",
      -      "dissolved",
      -      "coverage",
      -      "opaqueSleeves",
      -      "etfs",
      -      "omittedFunds",
      -      "omittedOpaqueSleeves"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "coverage": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "opaqueInherent": {
      +            "type": "number"
      +          },
      +          "opaquePending": {
      +            "type": "number"
      +          },
      +          "transparent": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "transparent",
      +          "opaqueInherent",
      +          "opaquePending"
      +        ],
      +        "type": "object"
      +      },
      +      "dissolved": {
      +        "additionalProperties": false,
      +        "description": "How the funds this counter counts resolved: fully dissolved, partly dissolved, or not at all. Funds that can be looked through, which means funds that can hold stocks. A bond, cash (money market, overnight), gold or crypto fund is never counted here: it cannot hold a listed company, so it is never dissolved and is reported instead as an opaque sleeve, held as a whole, in its own asset class. An equity fund whose constituent fetch failed IS counted, under `none`: it is a fund that can be looked through and has not been, which is a gap rather than a rule.",
      +        "properties": {
      +          "full": {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          "none": {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          },
      +          "partial": {
      +            "maximum": 9007199254740991,
      +            "minimum": -9007199254740991,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "full",
      +          "partial",
      +          "none"
      +        ],
      +        "type": "object"
      +      },
      +      "etfCount": {
      +        "description": "Funds that can be looked through, which means funds that can hold stocks. A bond, cash (money market, overnight), gold or crypto fund is never counted here: it cannot hold a listed company, so it is never dissolved and is reported instead as an opaque sleeve, held as a whole, in its own asset class. A fund is an ISIN, not a holding row: one ETF held at two brokers counts once, and the overlap pairs are drawn from this same population.",
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      "etfs": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "asOf": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "coveredWeight": {
      +              "type": "number"
      +            },
      +            "indexRead": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "fund": {
      +                  "type": "string"
      +                },
      +                "index": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "index",
      +                "fund"
      +              ],
      +              "type": "object"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "status": {
      +              "enum": [
      +                "full",
      +                "partial",
      +                "none"
      +              ],
      +              "type": "string"
      +            },
      +            "ticker": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "ticker",
      +            "name",
      +            "status",
      +            "coveredWeight",
      +            "asOf"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 50,
      +        "type": "array"
      +      },
      +      "omittedFunds": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "omittedOpaqueSleeves": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "opaqueSleeves": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "assetClass": {
      +              "type": "string"
      +            },
      +            "kind": {
      +              "enum": [
      +                "inherent",
      +                "pending"
      +              ],
      +              "type": "string"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "reason": {
      +              "description": "Serve-time localized text. The engine stores its reason key here; the serve layer replaces it with text in the caller's language.",
      +              "type": "string"
      +            },
      +            "reasonKey": {
      +              "description": "Language-free reason key. Absent on a payload cached before keys existed, whose `reason` then passes through as the German text the engine wrote (for example `Als Ganzes gehalten`), whatever the caller's language, until that payload is recomputed. `pending` covers two situations a caller may want to tell apart and today cannot: the constituent fetch failed on this run, and the provider returns no constituents for this wrapper at all, which no retry will change.",
      +              "enum": [
      +                "pending",
      +                "money-market",
      +                "bond-fund",
      +                "held-whole"
      +              ],
      +              "type": "string"
      +            },
      +            "ticker": {
      +              "type": "string"
      +            },
      +            "weight": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "ticker",
      +            "name",
      +            "weight",
      +            "kind",
      +            "reason",
      +            "assetClass"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 50,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "etfCount",
      +      "dissolved",
      +      "coverage",
      +      "opaqueSleeves",
      +      "etfs",
      +      "omittedFunds",
      +      "omittedOpaqueSleeves"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. First observed

TDQS

A4.2/5.0
Behavior5/5

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

With readOnlyHint/idempotentHint already covering safety, the description still adds several facts the annotations cannot convey: the snapshot-stability contract for paging ('restart on snapshot change'), the error mode ('Missing snapshots return unavailable'), and the authorization requirement ('portfolio:read and portfolio detail entitlement'). It also states that the two views cover the same capital, which prevents double counting.

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?

Six short sentences, front-loaded with the two views and followed by paging, failure, and permission rules, with no filler. The telegraphic fragments ('Preserve currency, dates, coverage and denominators') are efficient but ambiguous enough to cost a point.

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?

Output schema and full parameter descriptions already cover the return shape and argument syntax, so the description only needs to carry view selection, paging, failure, and access rules, which it does. The underspecified 'preserve ... denominators' clause and the undefined meaning of 'unavailable' are the remaining gaps.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds genuine meaning: 'restart on snapshot change' extends the computed_at schema text ('keep it when paging') into a consistency rule, and 'the two views cover the same capital' clarifies the view enum beyond 'never add both views'. 'Preserve currency, dates, coverage and denominators' is left unexplained, which limits the gain.

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?

Names a specific verb and resource ('Read whole-portfolio direct holdings') and explicitly enumerates the two views, 'direct' and 'look-through' pooled fund constituents, matching the view enum. An agent can tell this is a holdings retrieval rather than the analysis, correlation, or stress-test siblings, though it never says so by name.

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

Usage Guidelines4/5

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

Gives concrete operational guidance: choose one view, do not add both, page with computed_at, and restart when the snapshot changes. It does not compare against alternatives like get_portfolio_analysis or analyze_holdings, so the agent must infer when holdings vs. derived analysis is appropriate.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.