AnswerPool

SEC company snapshot

answerpool_sec_company

Read-only

One-call SEC snapshot of a US public company: recent filings, indexed events, insider activity, key XBRL facts (revenue, income, cash). $0.02/call.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`cik`	No
`ticker`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`cik`	Yes	Registrant's SEC Central Index Key, 10 digits zero-padded (e.g. 0000320193), resolved from the ticker when one was supplied. Use this form in other views.
`sic`	Yes	Standard Industrial Classification code for the registrant's primary industry as assigned by the SEC, typically 4 digits (e.g. 3571); null when EDGAR has none.
`name`	Yes	Registrant name as published on EDGAR's submissions record; empty string when EDGAR carries no name for the CIK.
`as_of`	Yes	ISO-8601 UTC timestamp with milliseconds (e.g. 2026-09-03T14:05:00.000Z) at which this snapshot was assembled. EDGAR is queried live, so it is the read time rather than a fixed data cut-off.
`facts`	Yes	XBRL financial series keyed by revenue, net_income, total_assets, cash, operating_cash_flow and shares_outstanding; each is up to the 8 most recent periods ordered oldest to newest. A key is absent when the registrant reports no matching concept, and the map is empty when XBRL company facts are unavailable.
`sources`	Yes	Public EDGAR API URLs this snapshot was compiled from, keyed `submissions` and `companyfacts`. Re-fetching them reproduces the underlying facts.
`tickers`	Yes	Every exchange ticker EDGAR lists for this registrant, uppercase, in EDGAR's own order. Empty for private, unlisted or deregistered filers.
`method_id`	No	Identifier and version of the rule set behind the flags and scores in `events_30d`. It changes when the method changes; results carrying different method_ids are not directly comparable.	sec_events_rules_v1
`disclaimer`	No	Fixed notice that this snapshot is compiled from public SEC filings and is not investment advice.	Compiled from public SEC filings; not investment advice.
`events_30d`	Yes	Events derived from this registrant's filings over the last 30 days, most recent first, capped at 50. Empty when nothing was filed or our event index does not yet cover the period.
`insider_90d`	Yes	Form 4 insider-trading summary for the last 90 days: `filings` (insider events counted), `buy_usd` and `sell_usd` (open-market purchase and sale value in whole US dollars) and `net_usd` (buy_usd minus sell_usd, negative on net selling).
`recent_filings`	Yes	Up to the 15 most recent filings of any form from EDGAR's submissions record, most recent first. Each element has `form`, `filed` (ISO-8601 filing date), `accession`, `description` (primary document description, may be empty) and `url` (index page).
`fiscal_year_end`	Yes	Registrant's fiscal year end as a four-character MMDD string (e.g. 0930 for 30 September); null when EDGAR has none on record.
`sic_description`	Yes	Industry title EDGAR pairs with `sic` (e.g. Electronic Computers); null whenever `sic` is null.
`state_of_incorporation`	Yes	Jurisdiction the registrant is incorporated in as a two-character code — a US state code such as DE, or an SEC country code. This is not the business address; null when EDGAR has none.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

Changed5 schema fields changedSep 5, 2026

addedOutput schema / $defs

Added value: +{
+  "Event": {
+    "properties": {
+      "accession": {
+        "description": "SEC accession number of the filing the event was derived from, in dashed form 0000000000-00-000000. Identifies the filing uniquely on EDGAR.",
+        "title": "Accession",
+        "type": "string"
+      },
+      "cik": {
+        "description": "SEC Central Index Key of the issuer, 10 digits zero-padded (e.g. 0000320193). For ownership and Form D events this is the issuer, never the reporting insider.",
+        "title": "Cik",
+        "type": "string"
+      },
+      "company": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Issuer or registrant name as carried on the filing; null when the source feed supplied no name.",
+        "title": "Company"
+      },
+      "event_id": {
+        "description": "Stable identifier for this event row, formatted `ev_` followed by 20 hex characters. Unique across the feed and safe to use for de-duplication between calls.",
+        "title": "Event Id",
+        "type": "string"
+      },
+      "event_type": {
+        "description": "Kind of event: `form_8k` (8-K current report), `insider_transaction` (ownership form reporting buys or sells) or `private_offering` (Form D exempt offering).",
+        "title": "Event Type",
+        "type": "string"
+      },
+      "filing_url": {
+        "description": "Absolute sec.gov URL of the filing's EDGAR index page, from which every document in the filing can be reached. Use it to verify the event against the source.",
+        "title": "Filing Url",
+        "type": "string"
+      },
+      "flags": {
+        "description": "Analytical tags derived for this filing (e.g. distress, leadership_change, large_insider_buy), sorted and de-duplicated; empty when nothing was flagged. The `sec_flag_glossary` view defines every flag we emit.",
+        "items": {
+          "type": "string"
+        },
+        "title": "Flags",
+        "type": "array"
+      },
+      "form": {
+        "description": "EDGAR form type of the source filing. The event index covers 8-K, D and the insider ownership forms, which are all recorded as `4`.",
+        "title": "Form",
+        "type": "string"
+      },
+      "occurred_at": {
+        "description": "When the filing became public on EDGAR: the filing date (ISO-8601 YYYY-MM-DD) for 8-K events, an ISO-8601 timestamp to the second for ownership and Form D events. This is the filing moment, not the date of the underlying transaction or event.",
+        "title": "Occurred At",
+        "type": "string"
+      },
+      "payload": {
+        "additionalProperties": true,
+        "description": "Form-specific detail. `form_8k` carries `items` (8-K item codes) and `labels`; `insider_transaction` carries `owner`, `buy_usd`, `sell_usd`, `n_buys`, `n_sells`; `private_offering` carries `total_offering_usd`, `sold_usd`, `investors`, `industry_group`, `state`, `is_amendment`. All USD amounts are whole dollars.",
+        "title": "Payload",
+        "type": "object"
+      },
+      "score": {
+        "anyOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "How notable this event is, 0 to 1, where higher means the flags on it are more materially significant; an event with no flags scores 0. Null when the row carries no score.",
+        "title": "Score"
+      },
+      "ticker": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Uppercase US exchange ticker for the issuer when one is known from the SEC ticker file; null for unlisted issuers, which is common on Form D.",
+        "title": "Ticker"
+      }
+    },
+    "required": [
+      "event_id",
+      "accession",
+      "cik",
+      "ticker",
+      "company",
+      "form",
+      "event_type",
+      "occurred_at",
+      "flags",
+      "score",
+      "payload",
+      "filing_url"
+    ],
+    "title": "Event",
+    "type": "object"
+  },
+  "FactPoint": {
+    "properties": {
+      "end": {
+        "description": "Last day of the period the figure covers, ISO-8601 YYYY-MM-DD, as tagged in the filing's XBRL: the measurement instant for balance-sheet items, the period end for flow items. This is a reporting-period boundary, not the filing date.",
+        "title": "End",
+        "type": "string"
+      },
+      "form": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "EDGAR form the figure was reported on. Only annual (10-K) and quarterly (10-Q) reports are included, so other form types never appear here.",
+        "title": "Form"
+      },
+      "fp": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Fiscal period the filing assigned to the figure: FY for a full year, or Q1, Q2, Q3 or Q4 for a quarter.",
+        "title": "Fp"
+      },
+      "fy": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Fiscal year the filing assigned to the figure (e.g. 2025). This is the registrant's own fiscal-year label and need not match the calendar year of `end`.",
+        "title": "Fy"
+      },
+      "value": {
+        "description": "Value exactly as reported, in the concept's native XBRL unit: US dollars for the monetary series and shares for shares_outstanding. Never rescaled or restated by us.",
+        "title": "Value",
+        "type": "number"
+      }
+    },
+    "required": [
+      "end",
+      "value"
+    ],
+    "title": "FactPoint",
+    "type": "object"
+  }
+}

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

addedOutput schema / properties

Added value: +{
+  "as_of": {
+    "description": "ISO-8601 UTC timestamp with milliseconds (e.g. 2026-09-03T14:05:00.000Z) at which this snapshot was assembled. EDGAR is queried live, so it is the read time rather than a fixed data cut-off.",
+    "title": "As Of",
+    "type": "string"
+  },
+  "cik": {
+    "description": "Registrant's SEC Central Index Key, 10 digits zero-padded (e.g. 0000320193), resolved from the ticker when one was supplied. Use this form in other views.",
+    "title": "Cik",
+    "type": "string"
+  },
+  "disclaimer": {
+    "default": "Compiled from public SEC filings; not investment advice.",
+    "description": "Fixed notice that this snapshot is compiled from public SEC filings and is not investment advice.",
+    "title": "Disclaimer",
+    "type": "string"
+  },
+  "events_30d": {
+    "description": "Events derived from this registrant's filings over the last 30 days, most recent first, capped at 50. Empty when nothing was filed or our event index does not yet cover the period.",
+    "items": {
+      "$ref": "#/$defs/Event"
+    },
+    "title": "Events 30D",
+    "type": "array"
+  },
+  "facts": {
+    "additionalProperties": {
+      "items": {
+        "$ref": "#/$defs/FactPoint"
+      },
+      "type": "array"
+    },
+    "description": "XBRL financial series keyed by revenue, net_income, total_assets, cash, operating_cash_flow and shares_outstanding; each is up to the 8 most recent periods ordered oldest to newest. A key is absent when the registrant reports no matching concept, and the map is empty when XBRL company facts are unavailable.",
+    "title": "Facts",
+    "type": "object"
+  },
+  "fiscal_year_end": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Registrant's fiscal year end as a four-character MMDD string (e.g. 0930 for 30 September); null when EDGAR has none on record.",
+    "title": "Fiscal Year End"
+  },
+  "insider_90d": {
+    "additionalProperties": true,
+    "description": "Form 4 insider-trading summary for the last 90 days: `filings` (insider events counted), `buy_usd` and `sell_usd` (open-market purchase and sale value in whole US dollars) and `net_usd` (buy_usd minus sell_usd, negative on net selling).",
+    "title": "Insider 90D",
+    "type": "object"
+  },
+  "method_id": {
+    "default": "sec_events_rules_v1",
+    "description": "Identifier and version of the rule set behind the flags and scores in `events_30d`. It changes when the method changes; results carrying different method_ids are not directly comparable.",
+    "title": "Method Id",
+    "type": "string"
+  },
+  "name": {
+    "description": "Registrant name as published on EDGAR's submissions record; empty string when EDGAR carries no name for the CIK.",
+    "title": "Name",
+    "type": "string"
+  },
+  "recent_filings": {
+    "description": "Up to the 15 most recent filings of any form from EDGAR's submissions record, most recent first. Each element has `form`, `filed` (ISO-8601 filing date), `accession`, `description` (primary document description, may be empty) and `url` (index page).",
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "title": "Recent Filings",
+    "type": "array"
+  },
+  "sic": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Standard Industrial Classification code for the registrant's primary industry as assigned by the SEC, typically 4 digits (e.g. 3571); null when EDGAR has none.",
+    "title": "Sic"
+  },
+  "sic_description": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Industry title EDGAR pairs with `sic` (e.g. Electronic Computers); null whenever `sic` is null.",
+    "title": "Sic Description"
+  },
+  "sources": {
+    "additionalProperties": {
+      "type": "string"
+    },
+    "description": "Public EDGAR API URLs this snapshot was compiled from, keyed `submissions` and `companyfacts`. Re-fetching them reproduces the underlying facts.",
+    "title": "Sources",
+    "type": "object"
+  },
+  "state_of_incorporation": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "description": "Jurisdiction the registrant is incorporated in as a two-character code — a US state code such as DE, or an SEC country code. This is not the business address; null when EDGAR has none.",
+    "title": "State Of Incorporation"
+  },
+  "tickers": {
+    "description": "Every exchange ticker EDGAR lists for this registrant, uppercase, in EDGAR's own order. Empty for private, unlisted or deregistered filers.",
+    "items": {
+      "type": "string"
+    },
+    "title": "Tickers",
+    "type": "array"
+  }
+}

addedOutput schema / required

Added value: +[
+  "cik",
+  "name",
+  "tickers",
+  "sic",
+  "sic_description",
+  "state_of_incorporation",
+  "fiscal_year_end",
+  "recent_filings",
+  "events_30d",
+  "insider_90d",
+  "facts",
+  "sources",
+  "as_of"
+]

changedOutput schema / title

Previous value: -"answerpool_sec_companyDictOutput"New value: +"CompanyOutput"

AddedSep 2, 2026

TDQS

B3.4/5.0

Behavior3/5

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

Annotations already declare readOnlyHint and destructiveHint false, covering the safety profile. The description adds useful context about output contents and the $0.02/call cost, but it does not disclose edge cases such as behavior when both cik and ticker are provided or when no match is found.

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?

A single front-loaded sentence conveys the core purpose, key content categories, and cost with no filler. Every phrase earns its place.

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

Completeness3/5

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

The description and output schema cover what the tool returns, but an agent still lacks guidance on how to identify the company via cik or ticker, whether one is required, or how conflicts are resolved. The omitted parameter-usage detail leaves the callable contract incomplete.

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 parameter descriptions are completely absent (0% coverage), and the description does not compensate by explaining cik or ticker, their formats, or that at least one appears needed despite both being nullable. The parameter names are somewhat self-explanatory, but the description adds no direct semantics.

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

Purpose5/5

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

The description clearly identifies the resource as a one-call SEC snapshot for US public companies and enumerates the specific data types (filings, events, insider activity, XBRL facts). This distinguishes it from sibling tools like catalog search or credit balance.

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

Usage Guidelines2/5

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

The description implies a use case for SEC company data but provides no explicit when-to-use guidance, no alternatives, and no mention that cik or ticker must be supplied. It does not say when this tool should be chosen over siblings or when it should not.

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

All AnswerPool tools Inspect

Try in Browser

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.7/5.0

Disambiguation3/5

Search, list, and get are clearly distinct, and credit_balance is unambiguous. However, answerpool_sec_company overlaps with answerpool_get since SEC company data is described as one of the many products reachable through get, which could confuse an agent about whether to use the generic get or the specialized tool.

Naming Consistency3/5

All tools share the answerpool_ prefix, but the suffix pattern is inconsistent: list_products and search_catalog follow verb_noun, get is a bare verb without an object, and credit_balance and sec_company are noun phrases. The naming is readable but not uniformly patterned.

Tool Count4/5

Five tools is a reasonable size for a data-product gateway: two discovery tools, one execution tool, an account tool, and a convenience shortcut. The count is appropriate, though sec_company is arguably redundant given answerpool_get.

Completeness4/5

The tool set covers the full user workflow: find products, list all products, execute a product, and check billing balance. Minor gaps exist, such as no way to inspect a single product's schema without listing everything and no general mechanism for product-specific convenience tools beyond sec_company, but no critical workflow is blocked.

Resources

Need Help?