{ "openapi": "3.0.1", "info": { "title": "CFPB Consumer Complaint Intelligence MCP — 5M+ Complaints", "description": "Search and analyze 5 million+ CFPB consumer complaints via a fully MCP-compatible server. Query by company, product category, state, issue type, and date range. Track complaint trends, identify systemic problems, and monitor company response rates. Works directly with Claude D...", "version": "0.1", "x-build-id": "FXNhmuXl3lC2RQ1C3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/andrew_avina~cfpb-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-andrew_avina-cfpb-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/andrew_avina~cfpb-mcp/runs": { "post": { "operationId": "runs-sync-andrew_avina-cfpb-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/andrew_avina~cfpb-mcp/run-sync": { "post": { "operationId": "run-sync-andrew_avina-cfpb-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "company": { "title": "Company Name", "type": "string", "description": "Filter complaints by company name. Partial match supported. Examples: 'Equifax', 'JPMorgan Chase', 'Wells Fargo', 'Citibank', 'Bank of America', 'Experian', 'TransUnion', 'Navient', 'Ally Financial'.", "default": "" }, "product": { "title": "Financial Product", "type": "string", "description": "Filter by product category. Options: 'Credit card', 'Mortgage', 'Student loan', 'Vehicle loan or lease', 'Debt collection', 'Credit reporting, credit repair services, or other personal consumer reports', 'Checking or savings account', 'Money transfer, virtual currency, or money service', 'Payday loan, title loan, or personal loan', 'Prepaid card'.", "default": "" }, "state": { "title": "US State", "type": "string", "description": "Filter by US state code (2 letters). Examples: CA, NY, TX, FL, IL, PA, OH, GA.", "default": "" }, "query": { "title": "Keyword Search", "type": "string", "description": "Full-text search across complaint narratives and fields.", "default": "" }, "dateFrom": { "title": "Date From (YYYY-MM-DD)", "type": "string", "description": "Only include complaints received on or after this date. Format: YYYY-MM-DD.", "default": "" }, "dateTo": { "title": "Date To (YYYY-MM-DD)", "type": "string", "description": "Only include complaints received on or before this date. Format: YYYY-MM-DD.", "default": "" }, "limit": { "title": "Result Limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of complaints to return (default 25, max 100).", "default": 25 }, "serveMcp": { "title": "MCP Server Mode", "type": "boolean", "description": "When enabled, starts an MCP-compatible HTTP server on port 4321 instead of running a batch query. Use this to connect Claude Desktop, Cursor, or any MCP client to live CFPB data. Exposes 4 tools: search_complaints, get_company_stats, get_product_trends, top_complained_companies.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }