`nic_get_hierarchy`

Pack: fed-nic · Endpoint: https://gateway.pipeworx.io/fed-nic/mcp

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

Corporate ownership hierarchy for a bank or holding company, sourced from the Federal Reserve NIC (ffiec.gov/npw) Relationships data — “which holding company owns this bank?” / “list the subsidiaries of this BHC”. direction=“up” (default) walks the ownership chain to its top holder(s) — for a bank subsidiary this typically resolves to a single ultimate parent (e.g. a bank holding company). direction=“down” lists entities OWNED BY the given RSSD ID; pass rssd_id of the TOP-TIER parent (found via direction=“up”) to get the full corporate family. total_subsidiary_count is a DISTINCT count computed in SQL (deduped by RSSD ID across multiple ownership paths to the same subsidiary) — it is always the true total, independent of limit/offset; use offset to page beyond the first limit rows. Coverage note: this is our own computed closure over NIC’s public Relationships file, not necessarily identical to NIC’s own web UI tiering figure — see pack README.

Parameters

Name	Type	Required	Description
`rssd_id`	number	yes	NIC RSSD ID to start from
`direction`	string	no	”up” (ancestors/owners, default) or “down” (subsidiaries/descendants)
`limit`	number	no	For direction=“down”: max subsidiary rows to return, 1-200, default 50 (total_subsidiary_count is always the true distinct total, not the page size)
`offset`	number	no	For direction=“down”: pagination offset into total_subsidiary_count, default 0

Example call

Arguments

{
  "rssd_id": 852218,
  "direction": "up"
}

curl

curl -X POST https://gateway.pipeworx.io/fed-nic/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nic_get_hierarchy","arguments":{"rssd_id":852218,"direction":"up"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nic_get_hierarchy', {
  "rssd_id": 852218,
  "direction": "up"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "fed-nic": {
      "url": "https://gateway.pipeworx.io/fed-nic/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

nic_get_hierarchy