🏦 FDIC BankFind MCP Server 🤠💻
About
Provides structured U.S. banking data from the FDIC BankFind API for AI tools and workflows.
Details
- License
- MIT
Explore
- Implements most FDIC BankFind API endpoints
- Provides seven tools: demographics, failures, history, institutions, locations, summary of deposits, and summary
- Supports advanced query parameters such as filters, sorting, and pagination
- Can return data in JSON, CSV, or XML formats
- Deployed as a Docker container from GitHub Container Registry
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🏦 FDIC BankFind MCP Server 🤠💻Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
---
1. To run the server in a container, you’ll need to have Docker installed. 🐳
2. Once Docker is installed, make sure it’s running! 🏃♂️💨
---
Once the image is published to GHCR you’ll be able to click a one-click install badge here. Until then, follow the manual steps below. 🛠️
Add the following JSON block to your User Settings (JSON) file. Open it with Ctrl + Shift + P → “Preferences: Open User Settings (JSON)”.
{
"mcp": {
"servers": {
"fdic": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/YOUR-ORG/fdic-bank-find-mcp-server:main"
]
}
}
}
}
> 💡 For workspace-specific config, place the same block (without the outer "mcp" key) in .vscode/mcp.json. Easy peasy! 🍋
{
"mcpServers": {
"fdic-bank-find": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/YOUR-ORG/fdic-bank-find-mcp-server:main"
]
}
}
}
Want to test, debug, or vibe with your MCP server in a beautiful UI? Enter the MCP Inspector! 🔍✨
You can run it directly (no install needed):
npx @modelcontextprotocol/inspector docker run -i --rm fdic-bank-find-mcp-server:main
Or install globally for convenience:
npm install -g @modelcontextprotocol/inspector
modelcontextprotocol-inspector docker run -i --rm fdic-bank-find-mcp-server:main
> The Inspector launches a local UI and pipes MCP requests/responses between your server and the interface. Perfect for debugging, prototyping, and showing off your API to friends, robots, or your boss. 😎🤖
---
api_key
Your FDIC API key (optional)
filters
Filter expression for advanced querying using FDIC BankFind syntax
fields
Comma-delimited list of fields to return
limit
Number of records to return
offset
Pagination offset
sort_by
Field to sort by
sort_order
Sort order (ASC/DESC)
file_format
Response format (json/csv/xml)
file_download
Download flag (if set, triggers file download)
file_name
Custom filename for download
get_demographics
Demographic summaries
get_failures
Historical bank failures
get_history
Structure change events
get_institutions
Institution demographics
get_locations
Branch locations
get_sod
Summary of Deposits
get_summary
Historical aggregates by year
All tools accept the following common parameters:
- api_key: Your FDIC API key (optional)
- filters: Filter expression for advanced querying using FDIC BankFind syntax
- fields: Comma-delimited list of fields to return
- limit: Number of records to return
- offset: Pagination offset
- sort_by: Field to sort by
- sort_order: Sort order (ASC/DESC)
- file_format: Response format (json/csv/xml)
- file_download: Download flag (if set, triggers file download)
- file_name: Custom filename for download
| 🛠️ Tool | 📖 Description | 🔑 Endpoint-Specific Key Parameters |
| ------------------ | ----------------------------- | ----------------------------------------------------------------------------------------- |
| get_demographics | Demographic summaries | |
| get_failures | Historical bank failures | agg_by, agg_limit, agg_sum_fields, agg_term_fields, total_fields, subtotal_by |
| get_history | Structure change events | search, agg_by, agg_limit, agg_term_fields |
| get_institutions | Institution demographics | search |
| get_locations | Branch locations | |
| get_sod | Summary of Deposits | agg_by, agg_limit, agg_sum_fields, agg_term_fields |
| get_summary | Historical aggregates by year | agg_by, agg_limit, agg_sum_fields, agg_term_fields, max_value, max_value_by |
> ℹ️ Need more details? Consult the FDIC docs for full field lists and semantics. 🧐
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83c\udfe6 fdic bankfind mcp server \ud83e\udd20\ud83d\udcbb": {
"fdic-bank-find-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/clafollett/fdic-bank-find-mcp-server:main"
]
}
}
}
}McpServers
{
"fdic-bank-find-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/clafollett/fdic-bank-find-mcp-server:main"
]
}
}---
The FDIC BankFind MCP Server is a Model Context Protocol (MCP) server that brings the power of FDIC BankFind APIs straight to your AI tools and workflows. Structured U.S. banking data, delivered with maximum vibes. 😎📊
---
💡 Use Cases
- Powering agent/LLM research on U.S. banks and institutions 🤖🏦
- Automating financial analytics, compliance, and reporting workflows 📈🧾
- Building AI-driven dashboards, bots, or custom fintech tools 🤠🤖
- Rapid prototyping for academic or market analysis 🎓📊
---
🛠️ Prerequisites
---
1. To run the server in a container, you’ll need to have Docker installed. 🐳
2. Once Docker is installed, make sure it’s running! 🏃♂️💨
---
Installation
🚀 Run the Official Public Docker Image (Recommended)
The FDIC BankFind MCP Server is published and ready to use from GitHub Container Registry (GHCR).
To run it (Docker will pull the image automatically if it's not present):
docker run -i --rm ghcr.io/clafollett/fdic-bank-find-mcp-server:main
You do NOT need to build the image yourself unless you want to develop or customize the server. For most users, just running the command above is all you need!
---
Build Steps (Manual Docker Build)
If you want to build the image yourself (for local development or custom changes):
1. Clone the repository:
git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
cd fdic-bank-find-mcp-server
2. Build the Docker image:
docker build -t fdic-bank-find-mcp-server:main .
This uses the included Dockerfile to build a release-mode Rust binary and package it into a minimal container.
3. Test the image locally:
docker run -i --rm fdic-bank-find-mcp-server:main
(The -i flag is required for stdio/MCP integration.)
4. Use the image in your MCP host config:
Follow the VS Code or Claude Desktop instructions below, referencing your local image as fdic-bank-find-mcp-server:main.
> If you’d like to tag/push to a registry, simply update the docker build and docker tag commands accordingly.
🧑💻 Usage with VS Code
Once the image is published to GHCR you’ll be able to click a one-click install badge here. Until then, follow the manual steps below. 🛠️
Add the following JSON block to your User Settings (JSON) file. Open it with Ctrl + Shift + P → “Preferences: Open User Settings (JSON)”.
{
"mcp": {
"servers": {
"fdic": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/YOUR-ORG/fdic-bank-find-mcp-server:main"
]
}
}
}
}
> 💡 For workspace-specific config, place the same block (without the outer "mcp" key) in .vscode/mcp.json. Easy peasy! 🍋
🤖 Usage with Claude Desktop (Conceptual)
{
"mcpServers": {
"fdic-bank-find": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/YOUR-ORG/fdic-bank-find-mcp-server:main"
]
}
}
}
🦀 Build from Source (Manual)
If you prefer not to use Docker (or want to hack on the server itself), you can compile the binary with the Rust toolchain and run it in stdio mode. 🦾
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
