@cyanheads/secedgar-mcp-server 0.15.8 → 0.15.9

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -25,6 +25,62 @@ export interface ToolDefinitionOptions {
  * it is present, so the manifest's tool count matches the documented surface.
  */
 export declare function buildToolDefinitions(options: ToolDefinitionOptions): (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    query: import("zod").ZodString;
+    include_filings: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    filing_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    filed_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+    filed_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    cik: import("zod").ZodString;
+    name: import("zod").ZodString;
+    tickers: import("zod").ZodArray<import("zod").ZodString>;
+    exchanges: import("zod").ZodArray<import("zod").ZodString>;
+    sic: import("zod").ZodString;
+    sic_description: import("zod").ZodString;
+    state_of_incorporation: import("zod").ZodOptional<import("zod").ZodString>;
+    fiscal_year_end: import("zod").ZodOptional<import("zod").ZodString>;
+    series_id: import("zod").ZodOptional<import("zod").ZodString>;
+    class_id: import("zod").ZodOptional<import("zod").ZodString>;
+    filings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        accession_number: import("zod").ZodString;
+        form: import("zod").ZodString;
+        filing_date: import("zod").ZodString;
+        report_date: import("zod").ZodOptional<import("zod").ZodString>;
+        primary_document: import("zod").ZodString;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>>;
+    total_filings: import("zod").ZodOptional<import("zod").ZodNumber>;
+    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
+    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        row_count: import("zod").ZodNumber;
+        expires_at: import("zod").ZodString;
+        truncated: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "no_match";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No company matches the query";
+    readonly recovery: "Check `data.suggestions` for near matches. SEC's ticker index reflects the filer's own submissions record, which can differ from the exchange-listed symbol. ETFs and mutual funds resolve only by ticker (e.g. \"VOO\"); operating companies also resolve by full legal name or 10-digit CIK.";
+}, {
+    readonly reason: "multiple_matches";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Query is ambiguous and matches several companies";
+    readonly recovery: "Specify a ticker symbol for an exact match instead of a name fragment.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
+    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
+    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
+    readonly retryable: true;
+    readonly thrownBy: "service";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     name: import("zod").ZodString;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     name: import("zod").ZodString;
@@ -175,62 +231,6 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
     readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
     readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    query: import("zod").ZodString;
-    include_filings: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
-    filing_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-    filed_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
-    filed_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    cik: import("zod").ZodString;
-    name: import("zod").ZodString;
-    tickers: import("zod").ZodArray<import("zod").ZodString>;
-    exchanges: import("zod").ZodArray<import("zod").ZodString>;
-    sic: import("zod").ZodString;
-    sic_description: import("zod").ZodString;
-    state_of_incorporation: import("zod").ZodOptional<import("zod").ZodString>;
-    fiscal_year_end: import("zod").ZodOptional<import("zod").ZodString>;
-    series_id: import("zod").ZodOptional<import("zod").ZodString>;
-    class_id: import("zod").ZodOptional<import("zod").ZodString>;
-    filings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
-        accession_number: import("zod").ZodString;
-        form: import("zod").ZodString;
-        filing_date: import("zod").ZodString;
-        report_date: import("zod").ZodOptional<import("zod").ZodString>;
-        primary_document: import("zod").ZodString;
-        description: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>>>;
-    total_filings: import("zod").ZodOptional<import("zod").ZodNumber>;
-    history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
-    dataset: import("zod").ZodOptional<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        row_count: import("zod").ZodNumber;
-        expires_at: import("zod").ZodString;
-        truncated: import("zod").ZodBoolean;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "no_match";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "No company matches the query";
-    readonly recovery: "Check `data.suggestions` for near matches. SEC's ticker index reflects the filer's own submissions record, which can differ from the exchange-listed symbol. ETFs and mutual funds resolve only by ticker (e.g. \"VOO\"); operating companies also resolve by full legal name or 10-digit CIK.";
-}, {
-    readonly reason: "multiple_matches";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Query is ambiguous and matches several companies";
-    readonly recovery: "Specify a ticker symbol for an exact match instead of a name fragment.";
-}, {
-    readonly reason: "rate_limited";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
-    readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
-    readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
-    readonly retryable: true;
-    readonly thrownBy: "service";
-}], {
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     query: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
     forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
@@ -451,6 +451,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
         form: import("zod").ZodString;
         filed: import("zod").ZodString;
         accession_number: import("zod").ZodString;
+        tag: import("zod").ZodString;
     }, import("zod/v4/core").$strip>>;
     tags_tried: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
     dataset: import("zod").ZodOptional<import("zod").ZodObject<{
@@ -469,6 +470,11 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "The company input resolves to multiple entities and the target is ambiguous";
     readonly recovery: "Use a ticker symbol or 10-digit CIK from the matches list for an exact match.";
+}, {
+    readonly reason: "unknown_concept";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
+    readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
 }, {
     readonly reason: "no_concept_data";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
@@ -527,6 +533,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
             period_end: import("zod").ZodString;
             form: import("zod").ZodString;
             accession_number: import("zod").ZodString;
+            tag: import("zod").ZodString;
         }, import("zod/v4/core").$strip>>;
         quarterly: import("zod").ZodOptional<import("zod").ZodObject<{
             period: import("zod").ZodString;
@@ -534,6 +541,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
             period_end: import("zod").ZodString;
             form: import("zod").ZodString;
             accession_number: import("zod").ZodString;
+            tag: import("zod").ZodString;
         }, import("zod/v4/core").$strip>>;
         instant: import("zod").ZodOptional<import("zod").ZodObject<{
             period: import("zod").ZodString;
@@ -541,6 +549,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
             period_end: import("zod").ZodString;
             form: import("zod").ZodString;
             accession_number: import("zod").ZodString;
+            tag: import("zod").ZodString;
         }, import("zod/v4/core").$strip>>;
     }, import("zod/v4/core").$strip>>;
     gaps: import("zod").ZodArray<import("zod").ZodObject<{
@@ -857,6 +866,10 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     concept: import("zod").ZodString;
+    taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
+        dei: "dei";
+        "us-gaap": "us-gaap";
+    }>>;
     period: import("zod").ZodString;
     unit: import("zod").ZodDefault<import("zod").ZodEnum<{
         USD: "USD";
@@ -873,6 +886,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     }>>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     concept: import("zod").ZodString;
+    taxonomy: import("zod").ZodString;
     period: import("zod").ZodString;
     unit: import("zod").ZodString;
     label: import("zod").ZodString;
@@ -913,7 +927,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
 }, import("zod/v4/core").$strip>, readonly [{
     readonly reason: "unknown_concept";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The concept input does not match a friendly name and SEC frames returned no data";
+    readonly when: "The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
     readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
 }, {
     readonly reason: "no_data";
@@ -988,6 +1002,11 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
         concept: import("zod").ZodString;
         tags_tried: import("zod").ZodArray<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>>;
+    unknown_concepts: import("zod").ZodArray<import("zod").ZodObject<{
+        concept: import("zod").ZodString;
+        derivation: import("zod").ZodOptional<import("zod").ZodString>;
+        suggestions: import("zod").ZodArray<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
     caveats: import("zod").ZodArray<import("zod").ZodString>;
     dataset: import("zod").ZodOptional<import("zod").ZodObject<{
         name: import("zod").ZodString;
@@ -1004,6 +1023,11 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly when: "Companies resolved but not one of them reports any of the requested concepts for the requested period type";
     readonly recovery: "Switch period_type, or discover reported concept names with secedgar_search_concepts.";
+}, {
+    readonly reason: "unknown_concept";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Every requested concept is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
+    readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
 }, {
     readonly reason: "rate_limited";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BlE"}

package/dist/mcp-server/tools/definitions/search-concepts.tool.d.ts

@@ -1,6 +1,7 @@
 /**
  * @fileoverview Search supported XBRL financial concepts by keyword, statement group, or taxonomy.
- * Discovery tool for the friendly names accepted by secedgar_get_financials and secedgar_fetch_frames.
+ * Discovery tool for the friendly names accepted by secedgar_get_financials,
+ * secedgar_compare_companies, and secedgar_fetch_frames.
  * Also performs reverse lookup: passing a raw XBRL tag returns the friendly mapping(s) it belongs to.
  * @module mcp-server/tools/definitions/search-concepts
  */

package/dist/mcp-server/tools/definitions/search-concepts.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-concepts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-concepts.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAkBjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8K7B,CAAC"}
+{"version":3,"file":"search-concepts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-concepts.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAkBjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8K7B,CAAC"}

package/dist/mcp-server/tools/definitions/search-concepts.tool.js

@@ -1,6 +1,7 @@
 /**
  * @fileoverview Search supported XBRL financial concepts by keyword, statement group, or taxonomy.
- * Discovery tool for the friendly names accepted by secedgar_get_financials and secedgar_fetch_frames.
+ * Discovery tool for the friendly names accepted by secedgar_get_financials,
+ * secedgar_compare_companies, and secedgar_fetch_frames.
  * Also performs reverse lookup: passing a raw XBRL tag returns the friendly mapping(s) it belongs to.
  * @module mcp-server/tools/definitions/search-concepts
  */
@@ -19,7 +20,7 @@ const TAXONOMY_VALUES = [
     'dei',
 ];
 export const searchConceptsTool = tool('secedgar_search_concepts', {
-    description: 'Search supported XBRL financial concepts by keyword, statement group, or taxonomy. Use before secedgar_get_financials or secedgar_fetch_frames to discover the right friendly name, or pass a raw XBRL tag (e.g., "NetIncomeLoss") to reverse-lookup which friendly names map to it. Empty search with no filters returns the full catalog.',
+    description: 'Search supported XBRL financial concepts by keyword, statement group, or taxonomy. Use before secedgar_get_financials, secedgar_compare_companies, or secedgar_fetch_frames to discover the right friendly name, or pass a raw XBRL tag (e.g., "NetIncomeLoss") to reverse-lookup which friendly names map to it. Empty search with no filters returns the full catalog.',
     annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
     input: z.object({
         search: z
@@ -29,7 +30,7 @@ export const searchConceptsTool = tool('secedgar_search_concepts', {
         group: z
             .enum(GROUP_VALUES)
             .optional()
-            .describe('Filter to a single financial statement group. income_statement covers P&L items; balance_sheet covers position items (use instant periods in secedgar_fetch_frames); cash_flow covers CF statement items; per_share covers EPS; entity_info covers DEI items like shares outstanding.'),
+            .describe('Filter to a single financial statement group. income_statement covers P&L items; balance_sheet covers position items (use instant periods in secedgar_fetch_frames); cash_flow covers CF statement items; per_share covers EPS and the diluted share count it divides by; entity_info covers DEI items like shares outstanding.'),
         taxonomy: z
             .enum(TAXONOMY_VALUES)
             .optional()
@@ -50,7 +51,7 @@ export const searchConceptsTool = tool('secedgar_search_concepts', {
             .object({
             name: z
                 .string()
-                .describe('Friendly name to pass as the concept argument to secedgar_get_financials or secedgar_fetch_frames.'),
+                .describe('Friendly name to pass as `concept` to secedgar_get_financials or secedgar_fetch_frames, or in `concepts` to secedgar_compare_companies.'),
             label: z.string().describe('Human-readable concept label.'),
             tags: z
                 .array(z.string())

package/dist/mcp-server/tools/definitions/search-concepts.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-concepts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-concepts.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search-concepts.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-concepts.tool.ts"],"names":[],"mappings":"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"}

package/dist/services/edgar/concept-map.d.ts

@@ -4,10 +4,43 @@
  */
 import type { ConceptMapping, ConceptTaxonomy, TagSelection } from './types.js';
 /**
- * Resolve a concept input to its mapping. Accepts friendly names or raw XBRL tags.
- * Returns undefined if the input is not a known friendly name (caller should treat it as a raw tag).
+ * Resolve a concept input to its mapping. Accepts friendly names in any case or
+ * separator form (`Net Income`, `NET_INCOME`), with surrounding whitespace ignored.
+ * Returns undefined if the input is not a known friendly name.
  */
 export declare function resolveConcept(input: string): ConceptMapping | undefined;
+/** A concept input that is neither a catalog name nor shaped like an XBRL element name. */
+export interface UnknownConcept {
+    /** The input as supplied, trimmed. */
+    concept: string;
+    /** How to build it from catalog concepts, when it is a standard combination of them. */
+    derivation?: string | undefined;
+    /** Up to three nearest catalog names. Empty when a derivation applies or nothing is close. */
+    suggestions: string[];
+}
+/**
+ * Recovery text for one unknown concept: its derivation or its suggestions,
+ * then the pointer to secedgar_search_concepts. Every surface that reports an
+ * unknown concept words it with this.
+ */
+export declare function unknownConceptHint(unknown: UnknownConcept): string;
+/**
+ * Classify a concept input before any company resolution or SEC request.
+ * Returns undefined for a catalog name (any case or separator form) and for
+ * anything shaped like an XBRL element name — a well-formed tag the filer does
+ * not report stays the tool's own no-data answer (#45). Everything else is
+ * unknown, with its derivation or nearest catalog names (#128).
+ */
+export declare function findUnknownConcept(input: string): UnknownConcept | undefined;
+/**
+ * Message and recovery hint for failing on one or more unknown concepts, so
+ * every tool words the failure the same way. One concept carries its own hint;
+ * several name each concept's detail in turn, then the shared closing sentence.
+ */
+export declare function describeUnknownConcepts(unknowns: readonly UnknownConcept[]): {
+    hint: string;
+    message: string;
+};
 /** What a caller-supplied concept resolves to before any lookup runs. */
 export interface ConceptTarget {
     /** Human-readable label — the mapping's label, or the raw tag itself. */
@@ -26,8 +59,9 @@ export interface ConceptTarget {
  * list to query. A friendly name that prefers its own taxonomy (`dei` for
  * shares_outstanding) keeps it unless the caller asked for something other than
  * the `us-gaap` default; `ifrs-full` uses the mapping's confirmed IFRS variants
- * when it has them and falls back to the standard tags otherwise. Unknown input
- * passes through as a raw XBRL tag under the requested taxonomy.
+ * when it has them and falls back to the standard tags otherwise. Any other
+ * input passes through, trimmed, as a raw XBRL tag under the requested
+ * taxonomy — callers reject what `findUnknownConcept` flags before this runs.
  */
 export declare function resolveConceptTarget(input: string, requestedTaxonomy: ConceptTaxonomy): ConceptTarget;
 /** Get all concept mappings for reference resource generation. */

package/dist/services/edgar/concept-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"concept-map.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/concept-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA4chF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGxE;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,YAAY,EAAE,YAAY,CAAC;IAC3B,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0CAA0C;IAC1C,QAAQ,EAAE,eAAe,CAAC;IAC1B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,eAAe,GACjC,aAAa,CAiBf;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAE/D;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAI7C;AAUD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAqB/E"}
+{"version":3,"file":"concept-map.d.ts","sourceRoot":"","sources":["../../../src/services/edgar/concept-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwhBhF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE;AAyDD,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8FAA8F;IAC9F,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAYD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAIlE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAc5E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,YAAY,EAAE,YAAY,CAAC;IAC3B,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0CAA0C;IAC1C,QAAQ,EAAE,eAAe,CAAC;IAC1B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,eAAe,GACjC,aAAa,CAkBf;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAE/D;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAI7C;AAUD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAqB/E"}