AlphaCreek SEC Filings MCP · AlphaCreek

{
  "name": "get_latest_filing",
  "description": "Return latest filing metadata for a company or ticker. If ticker and company are omitted, return newly ingested filings newest-first. Omit filing_registry in that mode to include both SEC and FCA. Company results include one metadata object; newly ingested results include a filings list. Each row includes Filing metadata object. Includes `document_type` (Canonical document type. SEC: 10-K, 10-Q, 20-F, 6-K, 8-K, DEF 14A. FCA: annual, half-year, press.) and, for FCA press rows, `announcement_type` (FCA press subtype when document_type is press; null for annual and half-year. Values: 1st Quarter Results, 2nd Quarter Results, 3rd Quarter Results, 4th Quarter Results, Final Results, Preliminary Results, Share Buyback, Trading Update.).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ticker": {
        "type": "string"
      },
      "company": {
        "type": "string"
      },
      "filing_registry": {
        "type": "string",
        "enum": [
          "sec_edgar",
          "fca_nsm"
        ],
        "description": "Filing source registry. sec_edgar — US SEC EDGAR. fca_nsm — UK FCA NSM. Omit with no ticker/company to list newly ingested filings from both registries."
      },
      "document_type": {
        "description": "Optional document type filter (canonical values only). See Field reference for allowed values per registry.",
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "10-K",
              "10-Q",
              "20-F",
              "6-K",
              "8-K",
              "DEF 14A",
              "annual",
              "half-year",
              "press"
            ]
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "10-K",
                "10-Q",
                "20-F",
                "6-K",
                "8-K",
                "DEF 14A",
                "annual",
                "half-year",
                "press"
              ]
            }
          }
        ]
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 25,
        "description": "Max newly ingested filings when ticker and company are omitted"
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "list_filings",
  "description": "List available filings for a ticker (newest first) with artifact_document_id and dates. Use filing_registry=fca_nsm for UK FCA NSM reports. Use this first when you need a specific reporting period, including DEF 14A proxy statements (pass document_type=DEF 14A). Each row includes Filing metadata object. Includes `document_type` (Canonical document type. SEC: 10-K, 10-Q, 20-F, 6-K, 8-K, DEF 14A. FCA: annual, half-year, press.) and, for FCA press rows, `announcement_type` (FCA press subtype when document_type is press; null for annual and half-year. Values: 1st Quarter Results, 2nd Quarter Results, 3rd Quarter Results, 4th Quarter Results, Final Results, Preliminary Results, Share Buyback, Trading Update.).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ticker": {
        "type": "string"
      },
      "company": {
        "type": "string"
      },
      "filing_registry": {
        "type": "string",
        "enum": [
          "sec_edgar",
          "fca_nsm"
        ],
        "default": "sec_edgar",
        "description": "Filing source registry. sec_edgar — US SEC EDGAR filings. fca_nsm — UK FCA National Storage Mechanism. Omit to search both registries."
      },
      "document_type": {
        "description": "Optional document type filter (canonical values only). See Field reference for allowed values per registry.",
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "10-K",
              "10-Q",
              "20-F",
              "6-K",
              "8-K",
              "DEF 14A",
              "annual",
              "half-year",
              "press"
            ]
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "10-K",
                "10-Q",
                "20-F",
                "6-K",
                "8-K",
                "DEF 14A",
                "annual",
                "half-year",
                "press"
              ]
            }
          }
        ]
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 25
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "get_filing_toc",
  "description": "Return the full filing table of contents for one filing. If artifact_document_id is omitted, resolves the single latest filing for ticker/company (and optional document_type) only. Use list_filings first to discover a specific reporting period. Pass document_type=DEF 14A for US proxy statements. For DEF 14A, TOC rows are native proxy section labels when the filing has a linked HTML TOC; otherwise they use sec-parser headings. For FCA filings, pass filing_registry=fca_nsm; TOC node ids are HTML page element ids (e.g. pf2a, page12, pageView1) for annual ESEF reports or sec-parser ids (e.g. sp-0000001) for half-year RNS HTML reports.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "artifact_document_id": {
        "type": "string"
      },
      "ticker": {
        "type": "string"
      },
      "company": {
        "type": "string"
      },
      "filing_registry": {
        "type": "string",
        "enum": [
          "sec_edgar",
          "fca_nsm"
        ],
        "default": "sec_edgar",
        "description": "Filing source registry. sec_edgar — US SEC EDGAR filings. fca_nsm — UK FCA National Storage Mechanism. Omit to search both registries."
      },
      "document_type": {
        "description": "Optional document type filter (canonical values only). See Field reference for allowed values per registry.",
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "10-K",
              "10-Q",
              "20-F",
              "6-K",
              "8-K",
              "DEF 14A",
              "annual",
              "half-year",
              "press"
            ]
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "10-K",
                "10-Q",
                "20-F",
                "6-K",
                "8-K",
                "DEF 14A",
                "annual",
                "half-year",
                "press"
              ]
            }
          }
        ]
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "read_node_content",
  "description": "Return content for one or more navigation nodes in a filing. Pass one node via node_id or several via node_ids, using the node ids from TOC lines (the same values shown as NODE_ID lines in this tool's output). Returns plain MCP text: an ARTIFACT_DOCUMENT_ID header, then per-node blocks with NODE_ID, TITLE, CITATION_URL, CITATION_MARKDOWN, CONTENT_START … CONTENT_END. Each block's CITATION_URL links to the reader location for that node; CITATION_MARKDOWN is the same link as ready-to-paste markdown [TITLE](CITATION_URL). A requested TOC node may expand into more granular child NODE_ID blocks, each with its own TITLE, CITATION_URL, and CITATION_MARKDOWN. Responses that include citations end with a CITATIONS_IN_THIS_RESPONSE list.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "artifact_document_id": {
        "type": "string"
      },
      "node_id": {
        "type": "string",
        "description": "Single node id from TOC / NODE_ID lines. For FCA filings this is the HTML page id (e.g. pf2a, page12, pageView1)."
      },
      "node_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Batch read: multiple node ids for one filing (same identifiers as NODE_ID / TOC)."
      }
    },
    "required": [
      "artifact_document_id"
    ],
    "additionalProperties": false
  }
}

{
  "name": "search_sec_event_filings",
  "description": "Search US SEC filing nodes for a disclosure claim. The search covers 8-K, 6-K, 10-K, 10-Q, and 20-F. Omit document_type to search all of those forms. Pass document_type to search only the forms you name. Do not use this for DEF 14A.\nHow to search:\n1. Always pass concept_groups. Every group is required (AND). Within each group's any_of list, one alternative must match (OR). Use 2-5 groups for separate parts of the claim: topic, action, metric, and a causal link when that link is essential. Example: geography + weaker demand + decline, or AI + productivity + margin. Add synonyms. English stemming covers inflections (decline/declined), not synonyms (sales is not revenue). Do not add a group for a detail the filing may leave implicit.\n2. query is optional. Each item is an exact adjacent-token phrase. Put alternate full phrasings in the same list. Query plus concept_groups is hybrid search: an exact phrase ranks first, so a generic phrase such as \"margin expansion\" can outrank the causal sentence you want. Prefer phrases that state the relationship. Do not pass a broad topic word alone. Do not search with query only. Omit query for concept-only search.\n3. start_date and end_date are required. tickers limits issuers. Optional document_type limits the search to one or more of 8-K, 6-K, 10-K, 10-Q, and 20-F. Omit it to search all of those forms.\nHow to continue:\n4. Each call returns one page. There is no total count. If HAS_MORE is true, call again with cursor set to NEXT_CURSOR and the same concept_groups, dates, query, tickers, ne_tickers, document_type, and match_scope. A cursor from different inputs is rejected. An empty page with HAS_MORE true is not the end: call again with that cursor. Stop when HAS_MORE is false or when later pages are not relevant.\n5. If a page is mostly co-occurrence (the terms appear, but not the claim), start a new search with no cursor. Add a concept group or exact causal phrases. If a page is too sparse, start a new search with no cursor and drop the least essential group. Do not change filters while passing a cursor.\n6. ne_tickers excludes issuers you have already reviewed. It does not load the next page.\nResults are candidates. Call read_node_content with document_id and node_id. node_id may start with sp-. Verify negation, causality, comparisons across periods, and numeric thresholds in the source text. Cite CITATION_MARKDOWN.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "Optional exact disclosure phrases for hybrid search (max 8). Each phrase requires adjacent tokens in order and does not use stemming. Send complete event phrasings, not standalone topics. Omit this field for concept-only search. Examples: [\"reduced capital expenditures\", \"lower capital spending\"]; [\"lost a major customer\", \"termination by our largest customer\"]; [\"workforce reduction\", \"reduce headcount\"].",
        "oneOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "minItems": 1,
            "maxItems": 8
          }
        ]
      },
      "concept_groups": {
        "type": "array",
        "minItems": 2,
        "maxItems": 6,
        "description": "Required stemmed concept groups. Every group must match (AND). Any one alternative inside any_of can satisfy its group (OR). Atlas ranks the matching filing nodes. Use 2-5 focused groups in most searches. Supply synonyms and alternate filing terms, but omit simple inflections because English stemming handles them. Do not use this field to prove numeric thresholds, negation, causality, or changes across several filings; retrieve candidates and verify those claims with read_node_content.",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "description": "Short role label, such as geography, direction, business_metric, technology, or customer_event."
            },
            "any_of": {
              "type": "array",
              "minItems": 1,
              "maxItems": 16,
              "items": {
                "type": "string",
                "minLength": 1
              },
              "description": "Synonyms or short phrases for one required concept. Any one can match. Multiword values are adjacent-token phrases. English stemming applies."
            }
          },
          "required": [
            "name",
            "any_of"
          ],
          "additionalProperties": false
        },
        "examples": [
          [
            {
              "name": "capital_spending",
              "any_of": [
                "capital expenditure",
                "CapEx",
                "capital spending"
              ]
            },
            {
              "name": "direction",
              "any_of": [
                "reduce",
                "lower",
                "cut"
              ]
            },
            {
              "name": "forward_looking",
              "any_of": [
                "guidance",
                "outlook",
                "expect"
              ]
            }
          ]
        ]
      },
      "start_date": {
        "type": "string",
        "description": "Inclusive start date on filing_date (YYYY-MM-DD)"
      },
      "end_date": {
        "type": "string",
        "description": "Inclusive end date on filing_date (YYYY-MM-DD)"
      },
      "tickers": {
        "description": "Optional. Search only these issuers (example: [\"NVDA\", \"MSFT\"]). Prefix a symbol with ! to omit it (same as ne_tickers). Max 50. Omit to search all issuers.",
        "oneOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "minItems": 1,
            "maxItems": 50
          }
        ]
      },
      "ne_tickers": {
        "description": "Optional. Omit these issuers (example: [\"HOOD\"] or [\"!HOOD\"]). This does not load the next page. Use cursor for that. Exclude wins if a ticker is in both lists. Max 50.",
        "oneOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "minItems": 1,
            "maxItems": 50
          }
        ]
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 30,
        "description": "Maximum matches on this page. Not a total count. At most 3 matches come from one filing. When HAS_MORE is true, pass cursor to read the next page."
      },
      "document_type": {
        "description": "Optional. Limit the search to one or more of \"8-K\", \"6-K\", \"10-K\", \"10-Q\", and \"20-F\". Omit to search all of those forms.",
        "oneOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "minItems": 1,
            "maxItems": 5
          }
        ]
      },
      "match_scope": {
        "type": "string",
        "enum": [
          "window",
          "node"
        ],
        "default": "node",
        "description": "node (default): Atlas ranks every matching filing node. window is accepted for compatibility and behaves like node."
      },
      "cursor": {
        "type": "string",
        "minLength": 1,
        "description": "Page id from the previous NEXT_CURSOR line. Copy it unchanged. Pass it only with the same concept_groups, dates, query, tickers, ne_tickers, document_type, and match_scope. A mismatch is rejected. Omit it to start a new search."
      }
    },
    "required": [
      "concept_groups",
      "start_date",
      "end_date"
    ],
    "additionalProperties": false
  }
}