Fin Codes API MCP server
Commit 29. Okt. 2026Validierung von IBANs, Bankcodes und Zahlungsempfängern sowie Screening von Personen gegen globale Sanktionslisten.
Auch bekannt als swiftcodesapi/fincodesapi-mcp, fincodesapi-mcp
- Stars
- 0
- Tools
- 11
- Downloads, 30 Tage
- —
- Neueste Version
- 1.0.1
- Letzter Commit
- 29. Okt. 2026
- Lizenz
- MIT
Was ist Fin Codes API MCP?
Fin Codes API ist ein MCP server. Validierung von IBANs, Bankcodes und Zahlungsempfängern sowie Screening von Personen gegen globale Sanktionslisten. Er stellt 11 Tools bereit, etwa lookup_iban, verify_iban_payee, lookup_bic.
Zusammenfassung generiert aus dem README des Projekts
Über Fin Codes API MCP server
Fin Codes API bietet einen remote MCP server, der KI-Assistenten mit globalen Bankreferenzdaten und Compliance-Tools verbindet. Entwickler können diesen Service über streamable HTTP transport in Clients wie Claude Code, VS Code, Cursor, Cline und Gemini CLI integrieren. Der Server erfordert einen Fin Codes API Account, der via OAuth oder über einen manuell erstellten API key authentifiziert werden kann, falls der Client kein OAuth unterstützt.
Der Server stellt elf spezialisierte Tools für die Validierung von Finanzdaten und Sicherheit bereit. Dazu gehören Funktionen zum Nachschlagen von IBANs, BIC/SWIFT-Details und verschiedenen regionalen Routing-Nummern für die USA, Kanada, Australien, Neuseeland, Indien, Mexiko und Argentinien. Er enthält außerdem ein Tool, um Namen gegen wichtige internationale Sanktionslisten zu prüfen, einschließlich der Register der EU, des UK, der UN, von OFAC sowie der Schweizer, australischen und kanadischen Behörden. Nutzer sollten beachten, dass Lookups das Kontingent des Account-Plans verbrauchen, während Payee-Checks die Prepaid Verification of Payee Credits nutzen.
Was du damit machen kannst
- 1Internationale Bankdaten validierenVerifiziere eine IBAN, um die zugehörige Bank, das Land und die BIC-Informationen abzurufen.
- 2Regionale Routing-Nummern prüfenIdentifiziere die spezifische Bank und Filiale, die mit einem australischen BSB-Code verknüpft ist.
- 3Sanctions Screening durchführenPrüfe einen spezifischen Namen gegen globale Sanktionslisten, um die Compliance sicherzustellen.
- 4Abgleich von Zahlungsempfänger und IBANVergleiche den Namen einer Person mit dem Inhaber einer europäischen IBAN, um Fehler zu vermeiden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Fin Codes API MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenFin Codes API MCP in Claude Code installieren
$ claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpFin Codes API MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}Fin Codes API MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"fincodesapi-mcp": {
"type": "http",
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}Fin Codes API MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"fincodesapi-mcp","type":"http","url":"https://mcp.fincodesapi.com/mcp"}'Fin Codes API MCP in Codex installieren
$ codex mcp add fincodesapi-mcp --url https://mcp.fincodesapi.com/mcpFin Codes API MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.fincodesapi-mcp] url = "https://mcp.fincodesapi.com/mcp"
Fin Codes API MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpFin Codes API MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp",
"type": "http"
}
}
}Fin Codes API MCP tools 11
Erkannt aus dem READMElookup_ibanverify_iban_payeelookup_biclookup_us_routing_numberlookup_canada_routing_numberlookup_australia_bsblookup_new_zealand_bank_codelookup_india_ifsclookup_mexico_clabelookup_argentina_cbuscreen_sanctions
| lookup_iban | — | |
| verify_iban_payee | — | |
| lookup_bic | — | |
| lookup_us_routing_number | — | |
| lookup_canada_routing_number | — | |
| lookup_australia_bsb | — | |
| lookup_new_zealand_bank_code | — | |
| lookup_india_ifsc | — | |
| lookup_mexico_clabe | — | |
| lookup_argentina_cbu | — | |
| screen_sanctions | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarswiftcodesapi/fincodesapi-mcp is public and reachablegithub.com/swiftcodesapi/fincodesapi-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-29github.com/swiftcodesapi/fincodesapi-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeHTTPS endpoint answered 401 (sign-in required)Bestanden
README
Auf GitHub ansehenFin Codes API MCP server
Connect your AI assistant to banking reference data, payee-name verification, and sanctions screening.
Hosted endpoint: https://mcp.fincodesapi.com/mcp
Transport: Streamable HTTP
Homepage and setup: https://fincodesapi.com/mcp-server
Official registry: com.fincodesapi/fincodesapi
This repository contains public connector configuration and documentation for the hosted service. It does not contain the proprietary backend, run a local server, or publish an npm, PyPI, or Docker package.
Connect
Add the endpoint as a remote HTTP MCP server in your client, then sign in to your Fin Codes API account through OAuth. Sign up at https://fincodesapi.com/sign-up if needed. OAuth-aware clients do not need a manually created API key.
Claude Code
claude mcp add --transport http fincodesapi https://mcp.fincodesapi.com/mcp
Run /mcp to sign in. In Claude Desktop or claude.ai, add the endpoint as a custom connector.
VS Code
Add to .vscode/mcp.json, then start the server and sign in:
{"servers":{"fincodesapi":{"type":"http","url":"https://mcp.fincodesapi.com/mcp"}}}
Cursor and other MCP clients
Add the remote endpoint in the client's MCP settings. The included mcp.json defines the connection; plugin.json is a portable Agent Plugins manifest. Client support and OAuth setup vary.
Cline
In Cline, open MCP Servers → Remote Servers, add the endpoint above, and choose Streamable HTTP. Complete OAuth authorization when prompted. If using JSON configuration, use Cline's transport spelling:
{"mcpServers":{"fincodesapi":{"type":"streamableHttp","url":"https://mcp.fincodesapi.com/mcp","disabled":false,"autoApprove":[]}}}
If OAuth is unavailable in your client version, create your own API token at https://fincodesapi.com/api-keys and add an Authorization: Bearer YOUR_API_KEY header locally. Keep the key out of shared files. Confirm that eleven tools appear and try looking up BSB 082-024.
See Cline's MCP documentation. Cline installation of this connector has not yet been independently tested.
Gemini CLI
gemini extensions install https://github.com/swiftcodesapi/fincodesapi-mcp
Run /mcp auth fincodesapi if prompted to sign in. The extension uses HTTP transport and OAuth discovery.
API-key clients
Clients without OAuth can use an API key created at https://fincodesapi.com/api-keys. Send Authorization: Bearer YOUR_API_KEY to the same endpoint. Store your real key in the client's secret store; never commit it to this repository.
Eleven tools
| Tool | Purpose |
|---|---|
lookup_iban |
Validate an IBAN and return bank, country, and BIC/SWIFT details |
verify_iban_payee |
Compare a supplied 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 sanctions lists |
Live MCP tool schemas are authoritative.
Examples
- “Validate DE57 1001 0010 0593 9081 19 and tell me its bank and BIC.”
- “Which bank and branch does Australian BSB 082-024 identify?”
- “Run the documented free payee verification fixture: does DE75512108001245126199 match John Doe?”
- “Screen the name Sadam Husein with a minimum match score of 95.”
The John Doe/IBAN pair is a documented test fixture. Its response does not establish real account ownership. Bank-code validity alone does not establish account existence or ownership. Sanctions name similarity requires review and does not establish identity or sanctioned status. The tools do not transfer money, execute trades, reverse-search private accounts by name, or determine creditworthiness.
Account and pricing
A Fin Codes API account is required. Lookups consume the account's plan quota; payee checks consume prepaid Verification of Payee credits. Plans and credits are purchased on https://fincodesapi.com/pricing. The connector does not process purchases or payments. A trial is available; current terms and limits are shown on the website.
Privacy and support
Inputs are sent to the hosted Fin Codes API service. Review https://fincodesapi.com/privacy-policy, https://fincodesapi.com/gdpr, and https://fincodesapi.com/terms-of-service before use. Support: andrej@fincodesapi.com or Contact us at https://fincodesapi.com/mcp-server.
License
The connector configuration and documentation in this repository are MIT licensed. The hosted service remains governed by its Terms of Service.
Fin Codes API MCP Fragen
Wie füge ich Fin Codes API MCP zu Claude Code hinzu?
Führe claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Fin Codes API MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Fin Codes API MCP?
Er stellt 11 Tools bereit, darunter lookup_iban, verify_iban_payee, lookup_bic, lookup_us_routing_number, lookup_canada_routing_number.
Wie verbinde ich mich mit dem Fin Codes API MCP server?
Du kannst den Endpoint als remote HTTP MCP server in deinem Client hinzufügen und dich via OAuth anmelden, oder einen API key nutzen, falls dein Client kein OAuth unterstützt.
Welche Tools sind in diesem Server verfügbar?
Der Server bietet elf Tools, darunter IBAN-Validierung, BIC/SWIFT-Auflösung, Lookups für Routing-Nummern in den USA, Kanada, Australien, Indien, Mexiko und Argentinien sowie Sanctions Screening.
Kann ich diesen Server ohne Account nutzen?
Nein, ein Fin Codes API Account ist erforderlich, um den Service zu nutzen. Lookups verbrauchen das Kontingent deines Plans oder deine Prepaid-Credits.
Ermöglicht mir dieser Server, Geld zu überweisen?
Nein, die Tools dienen ausschließlich der Datenabfrage und Verifizierung; sie führen keine Geldtransfers oder Trades aus.