`fintech_company_deep_dive`

Pack: fintech-intel · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/fintech_company_deep_dive for the schema, then POST the same URL with its arguments for the data.

Analyze a fintech company’s financials, risk profile, and regulatory history by stock ticker (e.g., “AAPL”). Returns SEC filings, income statements, stock quotes, consumer complaints, and company overview. A retired or reassigned ticker returns found:false with empty_reason ticker_not_current and the nearest company-name candidates, never a different company.

Parameters

Name	Type	Required	Description
`ticker`	string	yes	Stock ticker symbol (e.g., “AAPL”, “JPM”)
`_avKey`	string	no	Alpha Vantage API key (optional, for stock/financial data)
`_fredKey`	string	no	FRED API key (optional, for macro context)

Example call

Arguments

{
  "ticker": "SQ",
  "_avKey": "your-fintech-intel-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/fintech-intel/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fintech_company_deep_dive","arguments":{"ticker":"SQ","_avKey":"your-fintech-intel-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('fintech_company_deep_dive', {
  "ticker": "SQ",
  "_avKey": "your-fintech-intel-api-key"
});

More examples

{
  "ticker": "JPM",
  "_avKey": "your-fintech-intel-api-key",
  "_fredKey": "your-fintech-intel-api-key"
}

Response shape

Full JSON Schema

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "analysis": {
          "type": "string",
          "description": "Analysis type identifier"
        },
        "ticker": {
          "type": "string",
          "description": "Stock ticker symbol analyzed"
        },
        "cik": {
          "type": [
            "object",
            "null"
          ],
          "description": "SEC CIK lookup result or null if unavailable"
        },
        "sec_filings": {
          "type": [
            "object",
            "null"
          ],
          "description": "SEC 10-K filings data or null if unavailable"
        },
        "stock_quote": {
          "type": [
            "object",
            "null"
          ],
          "description": "Current stock quote data or null if unavailable"
        },
        "company_overview": {
          "type": [
            "object",
            "null"
          ],
          "description": "Company fundamentals and overview or null if unavailable"
        },
        "income_statement": {
          "type": [
            "object",
            "null"
          ],
          "description": "Income statement financials or null if unavailable"
        },
        "consumer_complaints": {
          "type": [
            "object",
            "null"
          ],
          "description": "CFPB consumer complaints or null if unavailable"
        },
        "macro_context": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "fed_funds_rate": {
              "type": [
                "object",
                "null"
              ],
              "description": "Federal funds rate data"
            },
            "treasury_10y": {
              "type": [
                "object",
                "null"
              ],
              "description": "10-year Treasury yield data"
            }
          },
          "description": "Macro economic context or null if FRED key not provided"
        },
        "recent_8k_events": {
          "type": "object",
          "properties": {
            "ticker": {
              "type": "string"
            },
            "days": {
              "type": "number"
            },
            "count": {
              "type": "number"
            },
            "events": {
              "type": "array"
            }
          }
        },
        "short_volume": {
          "type": "object",
          "properties": {
            "attribution": {
              "type": "string"
            },
            "license": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "kind": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "attribution": {
                  "type": "string"
                },
                "obligations": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            },
            "license_note": {
              "type": "string"
            },
            "found": {
              "type": "boolean"
            },
            "symbol": {
              "type": "string"
            },
            "date": {
              "type": "string"
            },
            "reason": {
              "type": "string"
            },
            "hint": {
              "type": "string"
            }
          }
        },
        "found": {
          "type": "boolean",
          "enum": [
            true
          ],
          "description": "Present and true on an answer; a miss is the found:false branch."
        },
        "empty_reason": {
          "type": "string",
          "description": "ticker_not_current: the symbol matched only a company name, so nothing was looked up"
        },
        "note": {
          "type": "string",
          "description": "Plain-language explanation of the refusal"
        },
        "candidates": {
          "type": "array",
          "description": "Nearest company-name matches (ticker, company_name, cik); name guesses, not the company asked about",
          "items": {
            "type": "object",
            "properties": {
              "ticker": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "company_name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "cik": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "required": [
        "analysis",
        "ticker",
        "cik",
        "sec_filings",
        "stock_quote",
        "company_overview",
        "income_statement",
        "consumer_complaints"
      ]
    },
    {
      "type": "object",
      "description": "A miss or an unavailable upstream: found:false with a reason and a hint (the shape check-found-false-schemas.mjs expects).",
      "properties": {
        "found": {
          "type": "boolean",
          "enum": [
            false
          ]
        }
      },
      "required": [
        "found"
      ]
    }
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the fintech-intel pack

{
  "mcpServers": {
    "fintech-intel": {
      "url": "https://gateway.pipeworx.io/fintech-intel/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

fintech_company_deep_dive