# BankDataStack

> Global bank & card data validation APIs — US routing numbers, card BINs, IBANs, and SWIFT/BIC codes — normalized into consistent JSON.
> Authentication: `Authorization: Bearer YOUR_KEY` header (an `X-API-Key: YOUR_KEY` header also works).
> Base URL: `https://www.bankdatastack.com/api/v1`
> Get a full key: https://www.bankdatastack.com/register (7-day free trial). Or get a free, low-quota sandbox key with no signup via the `register` MCP tool.
> MCP: `POST https://mcp.bankdatastack.com/mcp` (this server) — one tool per endpoint below, plus `register`.

## Endpoints

- **POST /routing/validate** (tool: `validate_routing_number`) — Validates a US bank routing number (ABA number): checks length, the ABA mod-10 checksum, and the assigned bank, then returns the bank's name, address, and ACH/wire eligibility.
- **POST /routing/database/lookup** (tool: `lookup_routing_number_db`) — Looks up a US routing number in the local database (19,000+ US banks and credit unions) — richer than validate_routing_number (full address, phone, revision date). Pass refresh=true to force a fresh upstream lookup.
- **POST /routing/database/search** (tool: `search_routing_numbers`) — Advanced multi-filter search across the local routing number database — bank, city, state, and/or zip. At least one filter is required. Paginated, max 10 results/page.
- **POST /routing/database/bank** (tool: `search_banks_by_name`) — Search the local routing number database by bank name (partial match). Paginated, max 10 results/page.
- **POST /routing/database/state** (tool: `search_banks_by_state`) — List banks and credit unions registered in a US state, from the local routing number database. Paginated, max 10 results/page.
- **POST /routing/database/city** (tool: `search_banks_by_city`) — List banks and credit unions registered in a city, from the local routing number database. Optionally narrow by state. Paginated, max 10 results/page.
- **POST /routing/database/zip** (tool: `search_banks_by_zip`) — List banks and credit unions registered in a ZIP code, from the local routing number database. Paginated, max 10 results/page.
- **POST /bin/lookup** (tool: `lookup_bin`) — Looks up a card Bank Identification Number (the first 6-8 digits of a card number) and returns the issuing bank, card brand (Visa/Mastercard/Amex/...), card type and level, and country.
- **POST /iban/validate** (tool: `validate_iban`) — Validates an International Bank Account Number: checks the country participates in IBAN, the length matches that country's format, and the MOD-97 checksum, then returns the country code, check digits, and BBAN.
- **POST /swift/lookup** (tool: `lookup_swift`) — Looks up a SWIFT/BIC code in the local registry and returns the associated bank, branch, city, address, and country.
- **POST /swift/search** (tool: `search_swift_codes`) — Advanced multi-filter search across the SWIFT/BIC registry — bank, city, country, and/or 2-letter country code. At least one filter is required. Paginated, max 10 results/page.
- **POST /swift/bank** (tool: `search_swift_by_bank`) — List all SWIFT/BIC codes for a bank name (partial match) — a bank can have multiple codes across branches. Paginated, max 10 results/page.
- **POST /swift/country** (tool: `search_swift_by_country`) — List all SWIFT/BIC codes registered in a country. Paginated, max 10 results/page.
- **POST /swift/city** (tool: `search_swift_by_city`) — List all SWIFT/BIC codes registered in a city. Optionally narrow by country code. Paginated, max 10 results/page.
- **POST /bic/validate** (tool: `validate_bic`) — Validates a BIC (same format as SWIFT) against the local registry and returns a detailed breakdown (bank code, country code, location code, branch code) alongside the bank, branch, and address.
- **POST /oauth/register + POST /oauth/token** (tool: `register`) — issue a free sandbox credential (200 requests/month, 5 req/min, 7-day expiry) with no human signup, no credit card.

---

For parameters, examples, and sample responses see: /llms-full.txt
Full docs: https://www.bankdatastack.com/docs
Agent auth details: https://www.bankdatastack.com/auth.md