Fin Codes API MCP server
2026년 10월 29일 커밋IBAN, 은행 코드, 수취인 이름을 검증하고 글로벌 제재 명단과 대조하여 개인을 스크리닝합니다.
다른 이름 swiftcodesapi/fincodesapi-mcp, fincodesapi-mcp
- 스타
- 0
- Tools
- 11
- 다운로드, 30일
- —
- 최신 버전
- 1.0.1
- 마지막 커밋
- 2026년 10월 29일
- 라이선스
- MIT
Fin Codes API MCP란?
Fin Codes API은(는) MCP server입니다. IBAN, 은행 코드, 수취인 이름을 검증하고 글로벌 제재 명단과 대조하여 개인을 스크리닝합니다. 11개 도구를 제공합니다. 예: lookup_iban, verify_iban_payee, lookup_bic.
프로젝트 README에서 생성된 요약
Fin Codes API MCP server 정보
Fin Codes API는 AI 어시스턴트를 글로벌 뱅킹 참조 데이터 및 컴플라이언스 도구와 연결하는 원격 MCP server를 제공합니다. 개발자는 streamable HTTP 전송 방식을 사용하여 Claude Code, VS Code, Cursor, Cline, Gemini CLI와 같은 클라이언트에 이 서비스를 통합할 수 있습니다. 이 server를 사용하려면 Fin Codes API 계정이 필요하며, OAuth를 통해 인증하거나 OAuth를 지원하지 않는 클라이언트를 위해 수동으로 생성한 API key를 사용할 수 있습니다.
이 server는 금융 데이터 검증 및 보안을 위한 11개의 전문 도구를 제공합니다. 여기에는 IBAN, BIC/SWIFT 상세 정보, 그리고 미국, 캐나다, 호주, 뉴질랜드, 인도, 멕시코, 아르헨티나의 다양한 지역 라우팅 번호를 조회하는 기능이 포함됩니다. 또한 EU, UK, UN, OFAC, 스위스, 호주, 캐나다 등록부를 포함한 주요 국제 제재 명단에서 이름을 스크리닝하는 도구도 갖추고 있습니다. 조회 시에는 계정 플랜의 할당량이 소모되며, 수취인 확인(Verification of Payee) 시에는 선불 크레딧이 사용된다는 점에 유의하시기 바랍니다.
활용 사례
- 1국제 은행 정보 검증IBAN을 검증하여 관련 은행, 국가 및 BIC 정보를 가져옵니다.
- 2지역 라우팅 번호 확인호주 BSB 코드와 연결된 특정 은행 및 지점을 식별합니다.
- 3제재 스크리닝 수행컴플라이언스 준수를 위해 특정 이름을 글로벌 제재 명단과 대조합니다.
- 4수취인 이름과 IBAN 일치 여부 확인오류 방지를 위해 개인의 이름과 유럽 IBAN의 소유자를 비교합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Fin Codes API MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Fin Codes API MCP 설치
$ claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpCursor에 Fin Codes API MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}VS Code에 Fin Codes API MCP 설치
.vscode/mcp.json
{
"servers": {
"fincodesapi-mcp": {
"type": "http",
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}VS Code CLI에 Fin Codes API MCP 설치
$ code --add-mcp '{"name":"fincodesapi-mcp","type":"http","url":"https://mcp.fincodesapi.com/mcp"}'Codex에 Fin Codes API MCP 설치
$ codex mcp add fincodesapi-mcp --url https://mcp.fincodesapi.com/mcpCodex config.toml에 Fin Codes API MCP 설치
~/.codex/config.toml
[mcp_servers.fincodesapi-mcp] url = "https://mcp.fincodesapi.com/mcp"
Gemini CLI에 Fin Codes API MCP 설치
$ gemini mcp add -s user --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpGemini settings.json에 Fin Codes API MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp",
"type": "http"
}
}
}Fin Codes API MCP 도구 11
README에서 감지됨lookup_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 | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능swiftcodesapi/fincodesapi-mcp is public and reachablegithub.com/swiftcodesapi/fincodesapi-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-29github.com/swiftcodesapi/fincodesapi-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음11 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기Fin 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 질문
Fin Codes API MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Fin Codes API MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Fin Codes API MCP는 어떤 도구를 제공하나요?
11개 도구를 제공합니다. 예: lookup_iban, verify_iban_payee, lookup_bic, lookup_us_routing_number, lookup_canada_routing_number.
Fin Codes API MCP server에 어떻게 연결하나요?
클라이언트에서 엔드포인트를 원격 HTTP MCP server로 추가하고 OAuth를 통해 로그인하거나, OAuth를 지원하지 않는 클라이언트의 경우 API key를 사용하면 됩니다.
이 server에서 사용할 수 있는 도구는 무엇인가요?
IBAN 검증, BIC/SWIFT 조회, 미국/캐나다/호주/인도/멕시코/아르헨티나 라우팅 번호 조회, 제재 스크리닝을 포함하여 총 11개의 도구를 제공합니다.
계정 없이 이 server를 사용할 수 있나요?
아니요, 서비스를 이용하려면 Fin Codes API 계정이 필요하며, 조회 시 사용 중인 플랜의 할당량 또는 선불 크레딧이 소모됩니다.
이 server로 송금을 할 수 있나요?
아니요, 제공되는 도구는 데이터 조회 및 검증 전용이며, 실제 송금이나 거래를 실행하지는 않습니다.