# Fin Codes API

> Fin Codes API is an MCP server for finance and payments. IBAN, BIC and bank-code lookups, payee checks and sanctions screening for assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $39 a month
- **Platforms:** API
- **Website:** https://fincodesapi.com/mcp-server
- **Repository:** https://github.com/swiftcodesapi/fincodesapi-mcp
- **MCP Registry name:** com.fincodesapi/fincodesapi
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Eleven tools cover reference data for banks in Europe, North America, Australia, New Zealand, India and Latin America. Beyond IBAN and BIC lookups there are routing-number tools for the US and Canada, an Australian BSB lookup, a New Zealand bank code lookup, Indian IFSC, Mexican CLABE and Argentine CBU validation. Results begin with a clear outcome such as VALID, NOT FOUND or NO MATCH, so the assistant does not have to infer it from raw data.

Two tools carry extra conditions. Payee verification compares a name with the holder of a supported European IBAN and is charged per check from a pre-paid balance, at $0.20 each; a documented test IBAN with the name John Doe works for free. Sanctions screening checks a name against EU, UK, UN, OFAC, Swiss, Australian and Canadian lists, and the vendor stresses that a match means a similar name is listed, not that the person is sanctioned.

Lookups count against your Fin Codes API plan. Sign in via OAuth, or use an API key as a bearer token.

## Features

- **Bank code lookups:** IBAN, BIC, US and Canadian routing numbers, BSB, IFSC, CLABE and CBU.
- **Payee verification:** Compare a name with a European IBAN holder.
- **Sanctions screening:** Screen names against seven sanctions lists.
- **Clear outcomes:** Results start with VALID, NOT FOUND or NO MATCH.
- **Revocable access:** Connected apps can be removed from your profile.

## Good for

- Validate an IBAN before sending a payment
- Look up which bank a BSB or IFSC belongs to
- Check a payee name before a transfer
- Screen a counterparty name against sanctions lists

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http fincodesapi https://mcp.fincodesapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.fincodesapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fincodesapi": {
      "url": "https://mcp.fincodesapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fincodesapi": {
      "type": "http",
      "url": "https://mcp.fincodesapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fincodesapi": {
      "serverUrl": "https://mcp.fincodesapi.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fincodesapi": {
      "type": "http",
      "url": "https://mcp.fincodesapi.com/mcp"
    }
  }
}
```

## Tools

- `lookup_iban`: Validate an IBAN and return bank, country and BIC/SWIFT details.
- `verify_iban_payee`: Compare a payee name with the holder of a supported European IBAN.
- `lookup_bic`: Resolve BIC/SWIFT bank and branch details.
- `lookup_us_routing_number`: Look up a US ABA routing number.
- `lookup_canada_routing_number`: Look up a Canadian routing number.
- `lookup_australia_bsb`: Look up an Australian BSB.
- `lookup_new_zealand_bank_code`: Look up a New Zealand bank and branch code.
- `lookup_india_ifsc`: Look up an Indian IFSC.
- `lookup_mexico_clabe`: Validate a Mexican CLABE and identify its bank.
- `lookup_argentina_cbu`: Validate an Argentine CBU and identify its bank.
- `screen_sanctions`: Screen a name against EU, UK, UN, OFAC, Swiss, Australian and Canadian lists.

## FAQ

### What does it cost?

The API has a 14-day free trial with no card, then plans from $39 a month; payee checks are $0.20 each.

### How do I try payee verification for free?

Use the documented test IBAN DE75512108001245126199 with the payee name John Doe.

### Does a sanctions match mean someone is sanctioned?

No. It means a similar name is listed and needs review.

### How do I sign in?

OAuth with your Fin Codes API account, or an API key sent as a bearer token.

### Is Fin Codes API free?

Fin Codes API is a paid product with a free trial. Paid plans start at $39 a month.

### How do I add Fin Codes API to Claude Code?

Run this command in your terminal: claude mcp add --transport http fincodesapi https://mcp.fincodesapi.com/mcp

### What are the best alternatives to Fin Codes API?

The closest alternatives to Fin Codes API are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/fin-codes-api
