Skip to main content
Glama

Company financial statements (premium)

get_company_financials
Read-only

Retrieve full SEC iXBRL financial statements for a company we cover, pre- and post-IPO, with derived margins, growth, leverage and return ratios per period. Interim periods carry annualized figures alongside the reported ones. Provide a symbol. PREMIUM: paid per call over x402 (USDC on Base); an unpaid call returns the payment terms, and a not-found is never charged. Same data and price as the HTTP endpoint /api/agent/financials/by-symbol/{symbol}.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "symbol": "<symbol>"
    },
    "name": "get_company_financials"
  }
}

Input Schema

NameRequiredDescriptionDefault
symbolYesUS ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote.

Output Schema

NameRequiredDescriptionDefault
cikNoSEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042.
symbolNoTicker symbol the company trades under now, upper case, e.g. CRCL.
companyNoRegistrant name as filed with the SEC, e.g. Circle Internet Group, Inc.
fetchedAtNoWhen we last read the statements from SEC, ISO 8601.
symbolNoteNoPresent only when the ticker you asked for has belonged to more than one company and the record served is not the current holder's. Absent on an ordinary lookup.
preIpoPeriodsNoPeriods reported in the registration statement, before the listing.
postIpoPeriodsNoPeriods from the 10-K, 10-Q and 20-F reports filed after the listing.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changed
    • changedOutput schema / properties / cik / description
      Previous value: -"SEC Central Index Key."New value: +"SEC Central Index Key: the registrant's permanent SEC identifier, as a 10-digit string with leading zeros, e.g. 0001876042."
    • changedOutput schema / properties / company / description
      Previous value: -"Registrant name."New value: +"Registrant name as filed with the SEC, e.g. Circle Internet Group, Inc."
    • changedOutput schema / properties / fetchedAt / description
      Previous value: -"When the statements were last extracted from SEC."New value: +"When we last read the statements from SEC, ISO 8601."
    • changedOutput schema / properties / postIpoPeriods / description
      Previous value: -"Periods from 10-K/10-Q/20-F filings after listing."New value: +"Periods from the 10-K, 10-Q and 20-F reports filed after the listing."
    • changedOutput schema / properties / preIpoPeriods / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "annualizedMetrics": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Interim periods only: flow items annualized to 12 months."
      -        },
      -        "currency": {
      -          "description": "Reporting currency.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "derived": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Computed ratios: margins, growth, leverage, returns."
      -        },
      -        "durationMonths": {
      -          "description": "Length of the period in months.",
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "fxToUsd": {
      -          "description": "Multiply by this to convert to USD.",
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "metrics": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Tagged line items as reported (revenue, net income, cash, debt, ...)."
      -        },
      -        "periodEndDate": {
      -          "description": "YYYY-MM-DD.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "periodStartDate": {
      -          "description": "YYYY-MM-DD.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "periodType": {
      -          "description": "Annual or interim, as filed.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "annualizationMethod": {
      +          "description": "How annualizedMetrics was made: ttm (last full year + this year to date − last year to date) or scaled (× 12 ÷ durationMonths).",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "annualizedMetrics": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Interim periods only: the flow items in metrics scaled to twelve months, so a quarter compares with a year. Balance-sheet items are copied unchanged."
      +        },
      +        "currency": {
      +          "description": "ISO 4217 currency the figures in metrics are in, e.g. USD, CNY. USD when absent.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "derived": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Ratios computed from metrics, in percent: grossMarginPct, operatingMarginPct, netMarginPct, fcfMarginPct, revenueGrowthPct, debtToAssetsPct, equityRatioPct, returnOnEquityPct, returnOnAssetsPct, cashToAssetsPct. A ratio is absent when an input is missing."
      +        },
      +        "durationMonths": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Length of the period in whole months: 12 for a year, 3 for a quarter, 6 or 9 for year-to-date, 0 for an Instant."
      +        },
      +        "fxRateDate": {
      +          "description": "Date the fxToUsd rate was taken, YYYY-MM-DD: the IPO date for pre-IPO periods, the period end for later ones.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "fxToUsd": {
      +          "description": "USD per one unit of currency. Multiply a figure by it to get USD. Absent for USD.",
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "metrics": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Statement line items as filed, keyed by line name, in currency, whole units (not thousands). Only the lines the filing reports are present. Every key is listed under Line items."
      +        },
      +        "periodEndDate": {
      +          "description": "Last day of the period, YYYY-MM-DD.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "periodStartDate": {
      +          "description": "First day of the period, YYYY-MM-DD. Absent for a balance-sheet-only period.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "periodType": {
      +          "description": "Annual, Quarterly, Semi-Annual, Nine Months Ended, Instant (a balance-sheet date with no income or cash-flow figures), or N-Day Period for any other length, e.g. 45-Day Period.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / preIpoPeriods / description
      Previous value: -"Periods reported in the registration statement, before listing."New value: +"Periods reported in the registration statement, before the listing."
    • changedOutput schema / properties / symbol / description
      Previous value: -"Ticker."New value: +"Ticker symbol the company trades under now, upper case, e.g. CRCL."
    • changedOutput schema / properties / symbolNote / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {},
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "currentHolderCik": {
      +        "description": "CIK of the company that holds the ticker today, when known.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "currentHolderName": {
      +        "description": "Name of the company that holds the ticker today, when known.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "reason": {
      +        "description": "Plain-language explanation of the mismatch.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "requestedSymbol": {
      +        "description": "The ticker you asked for.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "servedCik": {
      +        "description": "CIK of the company whose record this response holds.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / symbolNote / description
      Previous value: -"Present only when the requested ticker is contested: which registrant it belongs to now vs. the record served."New value: +"Present only when the ticker you asked for has belonged to more than one company and the record served is not the current holder's. Absent on an ordinary lookup."
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": true,
      +  "properties": {
      +    "cik": {
      +      "description": "SEC Central Index Key.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "company": {
      +      "description": "Registrant name.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "fetchedAt": {
      +      "description": "When the statements were last extracted from SEC.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "postIpoPeriods": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "$ref": "#/properties/preIpoPeriods/anyOf/0/items"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Periods from 10-K/10-Q/20-F filings after listing."
      +    },
      +    "preIpoPeriods": {
      +      "anyOf": [
      +        {
      +          "items": {
      +            "additionalProperties": true,
      +            "properties": {
      +              "annualizedMetrics": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Interim periods only: flow items annualized to 12 months."
      +              },
      +              "currency": {
      +                "description": "Reporting currency.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "derived": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Computed ratios: margins, growth, leverage, returns."
      +              },
      +              "durationMonths": {
      +                "description": "Length of the period in months.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fxToUsd": {
      +                "description": "Multiply by this to convert to USD.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "metrics": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {
      +                      "type": [
      +                        "number",
      +                        "null"
      +                      ]
      +                    },
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Tagged line items as reported (revenue, net income, cash, debt, ...)."
      +              },
      +              "periodEndDate": {
      +                "description": "YYYY-MM-DD.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "periodStartDate": {
      +                "description": "YYYY-MM-DD.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "periodType": {
      +                "description": "Annual or interim, as filed.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Periods reported in the registration statement, before listing."
      +    },
      +    "symbol": {
      +      "description": "Ticker.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "symbolNote": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": true,
      +          "properties": {},
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Present only when the requested ticker is contested: which registrant it belongs to now vs. the record served."
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / symbol / description
      Added value: +"US ticker symbol, e.g. CRCL. Case-insensitive. Tickers get reassigned, so a response may carry a symbolNote."
  4. Added

TDQS

A3.9/5.0
Behavior5/5

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

Annotations cover the safety profile (readOnly, non-destructive, non-open-world), and the description adds substantial behavior the annotations cannot express: paid per call over x402 in USDC on Base, unpaid calls return payment terms instead of data, not-found is never charged, interim periods carry annualized figures, and a response may include a symbolNote due to ticker reassignment. The per-call charge also explains the idempotentHint=false annotation, giving the agent a real reason to avoid redundant calls.

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?

Front-loaded with the data scope, then payment terms, then endpoint parity; nearly every clause carries information. Slight redundancy in restating the symbol requirement that the required field already enforces, and the HTTP endpoint reference is only marginally useful to an MCP caller.

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, the description does not need to explain return values, and it instead covers pricing, failure semantics and coverage scope. It leaves open what 'companies we cover' means in practice and how many periods come back, but nothing an agent needs to form a correct call is missing.

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 schema already documents the symbol format, case-insensitivity and the symbolNote edge case. The description only restates 'Provide a symbol', adding no syntax, format or edge-case meaning beyond the schema. Baseline 3 applies when the schema does the work.

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?

The description names a specific verb and resource plus scope: 'Retrieve full SEC iXBRL financial statements for a company we cover, pre- and post-IPO, with derived margins, growth, leverage and return ratios per period.' That is far more precise than a generic 'get financials'. It does not explicitly distinguish itself from the closest sibling, get_company_metrics, so it falls short of a 5.

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?

Usage is implied rather than stated: the reader can infer this is for full statements of a covered company and that a symbol is required. There is no explicit when-to-use/when-not, and no named alternative such as get_company_metrics for a lighter metrics query. The payment terms tell the agent what happens on an unpaid call but are not selection guidance.

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.