🏦 FDIC BankFind MCP Server 🤠💻

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. 🦾

# Clone & build
$ git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
$ cd fdic-bank-find-mcp-server
$ cargo build --release

Once built, configure your MCP host to invoke the executable directly. For example, in VS Code User Settings (JSON):

{
  "mcp": {
    "servers": {
      "fdic": {
        "command": "/path/to/repository/fdic-bank-find-mcp-server/target/release/fdic-

... [View full README on GitHub](https://github.com/clafollett/fdic-bank-find-mcp-server#readme)