{"id":13179,"library":"fdic-mcp-server","title":"FDIC BankFind MCP Server","description":"The `fdic-mcp-server` package provides an MCP (Model Context Protocol) server designed to interface with the FDIC BankFind Suite API. It enables AI agents and LLM hosts to programmatically access and analyze public banking records, including information on FDIC-insured institutions, bank failures, branch data, quarterly financials, and deposit statistics, without requiring custom API integration. The current stable version is 1.23.2, with active development indicated by frequent bug fix and feature releases, often multiple times a week as seen in the recent changelog. Its key differentiators include exposing BankFind datasets as MCP tools, preserving both human-readable and machine-readable responses, offering server-side analysis helpers for multi-bank comparison, and supporting both local stdio and remote HTTP hosts. It aims to provide a stable tool surface and machine-readable responses for complex financial queries.","status":"active","version":"1.23.2","language":"javascript","source_language":"en","source_url":"https://github.com/jflamb/fdic-mcp-server","tags":["javascript","fdic","bankfind","mcp","model-context-protocol","banking"],"install":[{"cmd":"npm install fdic-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add fdic-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add fdic-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package is a server application, not a library for direct JavaScript import. It is primarily executed as a command-line tool. 'npx' is the recommended way to run it without a global install.","wrong":"import { Server } from 'fdic-mcp-server';","symbol":"fdic-mcp-server (CLI)","correct":"npx fdic-mcp-server"},{"note":"For long-term or frequent use, global installation provides a convenient command-line executable. Direct programmatic control via 'require' is not the intended interaction pattern.","wrong":"require('fdic-mcp-server').start();","symbol":"fdic-mcp-server (Global Install)","correct":"npm install -g fdic-mcp-server\nfdic-mcp-server"},{"note":"When running from a local clone or build, the compiled JavaScript entry point is executed directly with Node.js. Avoid treating 'dist/index.js' as a library module to import into other applications.","wrong":"import * as fdicServer from 'fdic-mcp-server/dist/index.js';","symbol":"fdic-mcp-server (Local Execution)","correct":"node dist/index.js"}],"quickstart":{"code":"npx fdic-mcp-server --transport=http --port=3000 &\n\n# Wait for the server to start...\n\n# Example MCP client configuration (e.g., in a host's config.json):\nconst mcpConfig = {\n  \"mcpServers\": {\n    \"fdic\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fdic-mcp-server\"]\n    },\n    \"fdic_http\": {\n      \"url\": \"http://127.0.0.1:3000/mcp\"\n    }\n  }\n};\n\nconsole.log('MCP server running and configured. You can now use an MCP client to interact with it.');","lang":"javascript","description":"This quickstart demonstrates how to run the `fdic-mcp-server` locally using `npx` with HTTP transport and provides a minimal example of how an MCP client would configure access to it, either via command execution or a remote URL."},"warnings":[{"fix":"Upgrade your Node.js environment to version 20.0.0 or higher. Use 'nvm' or similar version managers for easier switching.","message":"The server explicitly requires Node.js version 20 or later. Running with older versions will result in execution errors.","severity":"breaking","affected_versions":"<=1.x"},{"fix":"Interact with `fdic-mcp-server` as an external process (via command line) or through its HTTP endpoint using an MCP-compatible client, as shown in the quickstart and usage examples.","message":"The package is designed as a server, not a library. Attempting to 'import' or 'require' symbols from it into another JavaScript application for direct programmatic control is not the intended use case and will likely fail or lead to unexpected behavior.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Set the `HOST` environment variable before running the server, e.g., `HOST=0.0.0.0 PORT=3000 node dist/index.js` for all interfaces.","message":"By default, the HTTP transport binds to `127.0.0.1`. If you need to access the server from a different host or specific network interface, you must explicitly set the `HOST` environment variable.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"If serving to browser-based clients from different origins, set the `ALLOWED_ORIGINS` environment variable to a comma-separated list of allowed URLs (e.g., `ALLOWED_ORIGINS=https://my-app.com,http://another-host:8080`).","message":"Browser-origin requests to the HTTP server are subject to `ALLOWED_ORIGINS` checks. If not explicitly configured, it allows only `localhost` and `127.0.0.1` on the configured port, plus non-browser requests without an Origin header.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"If you anticipate very large responses, override this limit by setting the `FDIC_MAX_RESPONSE_BYTES` environment variable to a higher value (e.g., `FDIC_MAX_RESPONSE_BYTES=10485760` for 10 MiB).","message":"The default maximum FDIC response size guard is 5 MiB (`5242880` bytes). Large queries that exceed this limit might be truncated or fail.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Update Node.js to version 20.0.0 or newer. Consider using 'nvm' for easy version management.","cause":"Running the server with an unsupported Node.js version.","error":"Error: The 'fdic-mcp-server' package requires Node.js version 20.0.0 or higher. You are running vX.Y.Z."},{"fix":"Change the `PORT` environment variable to an unused port (e.g., `PORT=4000 npx fdic-mcp-server`) or terminate the conflicting process.","cause":"Another process is already using the specified HTTP port (default 3000 or 8080 for containers).","error":"Error: listen EADDRINUSE: address already in use :::3000"},{"fix":"Ensure `npm` (and thus `npx`) is installed and in the system's PATH. If using a local clone, verify the `command` and `args` point to the correct `node` executable and `dist/index.js` path.","cause":"The MCP client host cannot find or execute the `npx` or `fdic-mcp-server` command in its environment.","error":"mcpServers.fdic.command: npx, args: [-y, fdic-mcp-server] -- Command not found or executable permission denied."},{"fix":"Verify the `fdic-mcp-server` is running, its HTTP endpoint URL is correct (e.g., `http://127.0.0.1:3000/mcp`), and there are no firewall or network connectivity issues.","cause":"Often indicates network issues, incorrect server URL, or the `fdic-mcp-server` not running when an MCP client tries to connect via HTTP.","error":"TypeError: fetch failed"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"fdic-mcp"}