FDIC BankFind

The FDIC BankFind MCP Server provides a structured MCP interface to the FDIC BankFind APIs, allowing you to integrate bank data into your AI tools and workflows with consistent, queryable endpoints.

How to use

You connect to the FDIC BankFind MCP Server from your MCP client to query bank data, run demographic or historical analytics, and assemble data-driven insights into your tools and dashboards. Use the server to power agent conversations, automate financial analytics, and prototype fintech or research workflows with standardized endpoints and common query parameters.

How to install

Prerequisites include Docker for containerized runs and, if you prefer building from source, Rust’s toolchain for compilation.

# Prerequisites
# 1) Install Docker (follow your platform's instructions)
# 2) Ensure Docker is running

# 3) Run the official public Docker image (recommended)
docker run -i --rm ghcr.io/clafollett/fdic-bank-find-mcp-server:main

Additional installation options

If you want to build the image yourself for local development or customization, you can clone the project, build the Docker image, and test locally.

# Clone the repository
git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
cd fdic-bank-find-mcp-server

# Build the Docker image
docker build -t fdic-bank-find-mcp-server:main .

# Test the image locally
docker run -i --rm fdic-bank-find-mcp-server:main

VS Code and local MCP host configuration

If you are wiring the server into a local MCP host via VS Code, add the following configuration block to your User Settings (JSON). This launches the official image as a container when you start the MCP server.

{
  "mcp": {
    "servers": {
      "fdic": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "ghcr.io/clafollett/fdic-bank-find-mcp-server:main"
        ]
      }
    }
  }
}

Local binary build (stdio)

If you prefer to run a locally built binary in stdio mode, build the release binary and point your MCP host at that executable.

# Build the release binary
git clone https://github.com/YOUR-ORG/fdic-bank-find-mcp-server.git
cd fdic-bank-find-mcp-server
cargo build --release

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

MCP Inspector (optional)

To test and debug your MCP server with a visual UI, you can run the MCP Inspector against your server.

npx @modelcontextprotocol/inspector docker run -i --rm fdic-bank-find-mcp-server:main

# Or install globally and run
npm install -g @modelcontextprotocol/inspector
modelcontextprotocol-inspector docker run -i --rm fdic-bank-find-mcp-server:main

Notes on usage patterns

All tool endpoints support a common set of parameters for filtering, projection, and pagination. You can specify an API key, filter expressions, which fields to return, and how many records to fetch. You can also request CSV, JSON, or XML formats and trigger file downloads when appropriate.

Security and access

Manage access by controlling who can start the MCP server and who can provide the API key. Treat the container or binary as a trusted backend component in your workflow. Do not expose sensitive keys in logs or shared configuration.

Troubleshooting

If the server fails to start, verify Docker is running, the image tag is correct, and that your MCP host configuration points to the right command or container. Check logs from the MCP host and the server container for error messages.

Available tools

get_demographics

Returns demographic summaries for banks and institutions.

get_failures

Fetches historical bank failure data with optional aggregations.

get_history

Provides structure change events and historical context.

get_institutions

Delivers institution demographics and related data.

get_locations

Returns branch location information.

get_sod

Provides Summary of Deposits data with optional aggregations.

get_summary

Offers historical aggregates by year with configurable fields.