Consumer-Complaint-Database-MCP
This repository contains a local-only MCP server for querying the U.S. Consumer Financial Protection Bureau (CFPB) Consumer Complaint Database. The server is designed to be launched via standard input/output, making it ideal for integration with tools such as Claude Desktop.
Files
complaints.py
– Main MCP server that exposes a single tool,search_complaints
, for retrieving complaint records from the CFPB API.pyproject.toml
– Minimal project metadata and dependency declarations.claude_desktop_config.json
– Example configuration for launching the server from Claude Desktop.
Requirements
- Python 3.11+
- uv or
pip
for installing dependencies
Required Python packages are listed in pyproject.toml
and include httpx
, mcp[cli]
, and python-dateutil
.
Setup (optional)
uv run
automatically creates a virtual environment, locks your dependencies,
syncs them, and then executes the script. If you plan to launch the server with
uv run complaints.py
, you can skip installing requirements ahead of time.
For users who prefer to pre-install packages or use plain pip
, install
dependencies with uv
:
Or with plain pip
:
Running
To launch the server directly from the command line for a smoke test:
The server runs over stdio only and waits for requests from an MCP-aware client (e.g., Claude Desktop).
Running tests
Execute the unit tests using Python's unittest discovery. From the repository root, run:
This requires the dependencies listed in pyproject.toml
to be installed.
Claude Desktop Configuration
The claude_desktop_config.json
file includes an example entry pointing to the complaints.py
script. Replace INSERTPATH
with the path to this repository on your machine and import the configuration into Claude Desktop.
References
- CFPB Consumer Complaint Database API documentation – underlying API used by this MCP server.
- Model Context Protocol quickstart tutorial – tutorial that helped build this example.
License
This project is licensed under the MIT License.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A local MCP server that enables users to query the CFPB Consumer Complaint Database through natural language, retrieving financial consumer complaint records via the CFPB API.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.Last updated -1743PythonMIT License
- -securityFlicense-qualityAn MCP Server that provides natural language access to Google's Firebase Realtime Database API, enabling database operations and management through conversation.Last updated -Python
- -securityAlicense-qualityMCP server that provides monitoring and analytics capabilities for MBBank accounts, allowing users to check balances, transaction history, card details, and savings information.Last updated -8PythonMIT License
- -securityFlicense-qualityAn MCP server that provides access to Mastercard's BIN Table Resource API, allowing users to look up and interact with Bank Identification Number data through natural language queries.Last updated -Python