`cfpb_top_companies`

Pack: cfpb · Endpoint: https://gateway.pipeworx.io/cfpb/mcp

Find companies with the most complaints in a date range. Returns ranked list with company names and complaint counts.

Parameters

Name	Type	Required	Description
`start_date`	string	no	Start date in YYYY-MM-DD format
`end_date`	string	no	End date in YYYY-MM-DD format
`product`	string	no	Optional product filter (e.g., “Mortgage”, “Credit card”)
`limit`	number	no	Number of top companies to return (default 10)

Example call

Arguments

{
  "start_date": "2023-01-01",
  "end_date": "2024-01-01",
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/cfpb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cfpb_top_companies","arguments":{"start_date":"2023-01-01","end_date":"2024-01-01","limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('cfpb_top_companies', {
  "start_date": "2023-01-01",
  "end_date": "2024-01-01",
  "limit": 10
});

More examples

{
  "start_date": "2023-06-01",
  "end_date": "2024-06-01",
  "product": "Mortgage",
  "limit": 15
}

Response shape

Always returns: filters, total_complaints, top_companies

Field	Type	Description
`filters`	object
`total_complaints`	number	Total complaints in period
`top_companies`	array	Ranked list of companies by complaint count

Full JSON Schema

{
  "type": "object",
  "properties": {
    "filters": {
      "type": "object",
      "properties": {
        "product": {
          "type": [
            "string",
            "null"
          ],
          "description": "Product filter applied"
        },
        "date_range": {
          "type": "object",
          "properties": {
            "start": {
              "type": [
                "string",
                "null"
              ],
              "description": "Start date of range"
            },
            "end": {
              "type": [
                "string",
                "null"
              ],
              "description": "End date of range"
            }
          }
        }
      }
    },
    "total_complaints": {
      "type": "number",
      "description": "Total complaints in period"
    },
    "top_companies": {
      "type": "array",
      "description": "Ranked list of companies by complaint count",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "number",
            "description": "Ranking position"
          },
          "company": {
            "type": "string",
            "description": "Company name"
          },
          "complaint_count": {
            "type": "number",
            "description": "Number of complaints"
          }
        },
        "required": [
          "rank",
          "company",
          "complaint_count"
        ]
      }
    }
  },
  "required": [
    "filters",
    "total_complaints",
    "top_companies"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

cfpb_top_companies