Deposit Insurance Calculator MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Deposit Insurance Calculator MCP Server
Production-grade Model Context Protocol (MCP) server that interfaces with federal deposit insurance regulations and calculations to replace traditional manual calculator lookups (such as legacy web calculators like FDIC EDIE).
Built for the GSA MCP Server and SI Agent Government Hackathon and optimized for zero-configuration container deployment on Databricks Apps.
Disclaimer: This project is developed independently using publicly available regulations, documentation, and tools (including 12 CFR Part 330 and the FDIC Financial Institution Employee's Guide). This is not an official FDIC tool, software, or Model Context Protocol (MCP) server, and is not affiliated with, sponsored by, or endorsed by the Federal Deposit Insurance Corporation (FDIC) or the U.S. Government.
ποΈ Regulatory Authority & Compliance
The calculation engine implements deposit insurance rules sourced directly from:
12 CFR Part 330 (Deposit Insurance Regulations)
FDIC Financial Institution Employeeβs Guide to Deposit Insurance
FDIC Trust Rule Simplification (Effective April 1, 2024): Merged revocable and irrevocable trusts under 12 CFR Β§ 330.10, establishing a unified formula capped at 5 eligible beneficiaries per grantor ($1,250,000 maximum per grantor per insured institution).
Public Unit Deposit Regulations (12 CFR Β§ 330.15): Distinct bifurcated treatment for in-state institutions (separate $250,000 pools for demand deposits vs. time/savings deposits, enabling up to $500,000 per official custodian) vs. out-of-state institutions ($250,000 aggregate cap).
Related MCP server: Bancadia MCP
π Key Features
Pydantic v2 Validation: Strict schemas for ownership categories (
single,joint,trust,business,government,retirement), non-negative balances, and multi-owner configurations.FastMCP Streamable HTTP Transport: Exposes MCP tools over Streamable HTTP mounted at
/mcp, interoperable with both stateful MCP clients and stateless JSON-RPC callers.Databricks Apps Compatibility: Dynamic port resolution via the
DATABRICKS_APP_PORTenvironment variable (default:8000), container-ready host binding0.0.0.0, and companionapp.yaml.Dual API Interfaces:
MCP Tools:
calculate_deposit_insuranceandget_insurance_rule_guidancefor AI agents.REST Endpoints:
/api/calculate,/api/guidance,/health, and Swagger/docsfor traditional web dashboards and monitoring probes.
Actionable Optimization Guidance: Computes exact insured and uninsured amounts, and generates actionable restructuring advice (e.g., establishing POD trusts, ICS reciprocal networks, or collateralized public deposit protection).
π System Architecture
flowchart TD
Client[AI Agent / LLM Client / Databricks Agent] -->|Streamable HTTP /mcp| FastAPI[FastAPI Application]
Monitoring[Uptime / Health Probe] -->|HTTP GET /health| FastAPI
RESTClient[Web App / REST Caller] -->|HTTP POST /api/calculate| FastAPI
FastAPI --> MCPHandler[FastMCP Streamable HTTP Engine]
FastAPI --> RestRoutes[REST API Handlers]
MCPHandler --> Tools[MCP Tools Registry]
Tools --> T1[calculate_deposit_insurance]
Tools --> T2[get_insurance_rule_guidance]
T1 --> Engine[FDIC Calculation Engine]
T2 --> KnowledgeBase[12 CFR Part 330 Knowledge Base]
RestRoutes --> Engine
RestRoutes --> KnowledgeBase
Engine --> Rules[12 CFR Β§ 330.6 Single Accounts\n12 CFR Β§ 330.9 Joint Accounts\n12 CFR Β§ 330.10 Trust Accounts\n12 CFR Β§ 330.11 Business Accounts\n12 CFR Β§ 330.15 Government Accounts\n12 CFR Β§ 330.14 Retirement Accounts]π οΈ MCP Tools Overview
1. calculate_deposit_insurance
Evaluates a list of deposit accounts and returns full portfolio totals, bank breakdowns, statutory category breakdowns, individual account allocations, and optimization recommendations.
Input Parameters (AccountInput):
Field | Type | Description |
|
| Unique identifier (e.g., |
|
| Human-readable label (e.g., |
|
|
|
|
| Account ledger balance (must be |
|
|
|
|
| Insured institution name (default: |
|
| Owner/grantor names (required for joint accounts with |
|
| Beneficiary names for trust accounts (capped at 5 per grantor under 2024 rule) |
|
| If true, business account aggregates under owner's single accounts |
|
| Custodian with plenary custody for public unit accounts |
|
|
|
2. get_insurance_rule_guidance
Returns official regulatory guidance, formulas, statutory citations, and common pitfalls for specific categories or topics.
Parameters:
category(optional):"single","joint","trust","business","government","retirement"topic(optional): E.g.,"2024 trust rule","death grace period","merger grace period","uninsured investments","sole proprietorship"
π¦ Project Structure
.
βββ app.yaml # Databricks Apps application deployment manifest
βββ requirements.txt # Production dependencies
βββ server.py # Main FastMCP server and FastAPI application entrypoint
βββ deposit_insurance_engine.py # Calculation engine, Pydantic schemas & regulatory rule repository
βββ local_test.py # Standalone verification script (runs 5 test phases locally)
βββ tests/
β βββ test_server.py # Comprehensive pytest test suite (23 test cases)
βββ README.md # Project documentation and compliance guideπ§ͺ Local Testing & Parallel Verification with FDIC Deposit Insurance Calculator
1. Parallel Differential Testing (Deposit Insurance Calculator JS vs. Python MCP Server)
The repository includes a parallel differential testing harness that downloads and runs the actual calculation algorithms from https://edie.fdic.gov/javascript/edie.js via Node.js in parallel with the Python MCP Server, ensuring 100% mathematical parity:
# Run visual side-by-side comparison
python parallel_test_runner.py
# Run automated differential test suite
python -m pytest -v tests/test_parallel_calculator.py2. Full Regression Test Suite (37 Tests)
Run all 37 unit, integration, and parallel differential tests:
python -m pytest -v tests/3. Run Standalone Local Verification Script
Run the built-in end-to-end verification script:
python local_test.pyOutput:
======================================================================
FDIC DEPOSIT INSURANCE MCP SERVER - LOCAL VERIFICATION
======================================================================
[Step 1/5] Testing Health Check Endpoint (/health)...
--> Status: HEALTHY
--> Service: fdic-deposit-insurance-mcp
--> Port: 8000
--> Tools Loaded: calculate_deposit_insurance, get_insurance_rule_guidance
[Step 2/5] Testing Root Discovery Endpoint (/)...
--> Service: FDIC Deposit Insurance MCP Server
--> Regulatory Compliance: 12 CFR Part 330, FDIC Financial Institution Employee's Guide...
--> MCP Path: /mcp
[Step 3/5] Testing REST Calculation API (/api/calculate)...
--> Total Portfolio Balance: $3,150,000.00
--> Total Insured: $2,750,000.00
--> Total Uninsured: $400,000.00
--> Insurance Coverage: 87.3%
[Step 4/5] Testing MCP Streamable HTTP Transport (/mcp/ -> tools/list)...
--> MCP Streamable HTTP Protocol Handshake: SUCCESS (HTTP 200)
--> Discovered Tools: calculate_deposit_insurance, get_insurance_rule_guidance
[Step 5/5] Invoking calculate_deposit_insurance via MCP JSON-RPC Protocol...
--> MCP Tool Call: SUCCESS
--> 2024 FDIC Trust Rule Verification:
Grantor Alice has 7 beneficiaries, capped at 5 ($1,250,000 maximum).
Result correctly reports $1,250,000 Insured, $250,000 Uninsured.
======================================================================
ALL LOCAL INTEGRATION TESTS COMPLETED SUCCESSFULLY (100% PASS)
======================================================================Step 4: Run the Live Server
Start the server locally:
python server.pyOpen http://localhost:8000/docs in your browser to inspect interactive OpenAPI documentation.
βοΈ Databricks Apps Deployment
This server is pre-configured for Databricks Apps using app.yaml:
command:
- "python"
- "server.py"
env:
- name: "PYTHONUNBUFFERED"
value: "1"
- name: "DATABRICKS_APP_PORT"
value: "8000"Deploy the folder directly to your Databricks Workspace under Compute > Apps.
Databricks Apps automatically assigns a port via
DATABRICKS_APP_PORTand routes external traffic to the container.Access the MCP endpoint at
https://<databricks-app-url>/mcp.
π‘ Sample MCP Invocations
Example: Trust Account (April 1, 2024 Simplification Rule)
Request Payload:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calculate_deposit_insurance",
"arguments": {
"accounts": [
{
"account_id": "TRST-001",
"account_name": "Smith Family Revocable Trust",
"category": "trust",
"balance": 1800000.0,
"owners": ["John Smith", "Mary Smith"],
"beneficiaries": ["Child A", "Child B", "Child C"]
}
]
}
}
}Calculation Breakdown:
Number of Grantors:
2(John Smith, Mary Smith)Eligible Beneficiaries:
3(Child A, Child B, Child C)Maximum Coverage Limit:
2 grantors Γ 3 beneficiaries Γ $250,000 = $1,500,000Balance:
$1,800,000.00Insured Amount:
$1,500,000.00Uninsured Balance:
$300,000.00Recommendation: Restructure $300,000 to another FDIC-insured institution to maintain 100% coverage.
βοΈ Legal & Government Open Source Compliance
Federal Source Code Policy: Open-source public domain software designed for US Government inter-agency reuse.
Section 508 Accessibility: Structured machine-readable JSON schemas and descriptive text outputs ensuring accessibility for assistive technology and conversational agents.
FDIC Statutory Notice: Calculations are provided for educational and estimation purposes in accordance with 12 CFR Part 330. Actual insurance claims upon bank failure are resolved based on the official records of the failed institution.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Agent-native insurance quoting protocol β sandbox, MCP + REST, eligibility pre-flight
FDIC MCP β FDIC BankFind Suite API (free, no auth)
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Real, bindable home & auto insurance quotes via MCP β actual carrier rates, not estimates. Texas today, expanding across the US. AI agents can check eligibility, run a live multi-carrier quote, compare options (carrier names hidden until bind), and hand the customer a secure link where a licensed agent finalizes coverage β never an automated purchase. No sign-up or API key required; optional free partner keys for integrators.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that exposes life-insurance back-office tools (policy document search, application status, product/underwriting rules) to LLM agents. Enables agents to retrieve policy documents, check application status, and evaluate underwriting rules via hybrid search and rule lookup.3MIT

Bancadia MCPofficial
AlicenseNot gradedqualityBmaintenanceSearch and compare US business bank accounts. Query Bancadiaβs registry of business checking products (more financial products coming) with filters for monthly fees, APY, minimum balances, entity types (LLC, C-corp, nonprofit), and accounting or payment integrations. Agents get current account listings and can recommend the best fit for a startup or small business.ISC
eqlx-ifrs9official
AlicenseNot gradedqualityCmaintenanceA read-only MCP server that lets AI agents compute deterministic IFRS 9 expected credit loss from local loan and settings files: stage allocation, 12-month and lifetime ECL, scenario weighting, PD term structures, provision matrices, and Turkey BDDK reclassification checks. Every result is accompanied by the rules, settings and per-loan reasoning that produced it, with nothing written and no data leaving the machine.Apache 2.0- AlicenseAqualityBmaintenanceEnables AI agents to perform deterministic financial, accounting, tax, credit, and valuation calculations and SEC filing footnote audits across U.S. jurisdictions. It exposes CPU-based computation engines and live statutory-rate tools through remote or local MCP connections.8MIT