MCP server Fin Codes API
Commit 29 de out. de 2026Valide IBANs, códigos bancários e nomes de beneficiários enquanto realiza a triagem de indivíduos em listas globais de sanções.
Também conhecido como swiftcodesapi/fincodesapi-mcp, fincodesapi-mcp
- Stars
- 0
- Ferramentas
- 11
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.1
- Último commit
- 29 de out. de 2026
- Licença
- MIT
O que é o MCP Fin Codes API?
Fin Codes API é um MCP server. Valide IBANs, códigos bancários e nomes de beneficiários enquanto realiza a triagem de indivíduos em listas globais de sanções. Ele expõe 11 ferramentas, como lookup_iban, verify_iban_payee, lookup_bic.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Fin Codes API
O Fin Codes API fornece um remote MCP server que conecta assistentes de IA a dados de referência bancária global e ferramentas de compliance. Desenvolvedores podem integrar este serviço em clientes como Claude Code, VS Code, Cursor, Cline e Gemini CLI usando o transporte streamable HTTP. O server requer uma conta no Fin Codes API, que pode ser autenticada via OAuth ou por meio de uma API key criada manualmente para clientes que não suportam OAuth.
O server disponibiliza onze ferramentas especializadas para validação de dados financeiros e segurança. Isso inclui funções para consultar IBANs, detalhes de BIC/SWIFT e diversos routing numbers regionais para EUA, Canadá, Austrália, Nova Zelândia, Índia, México e Argentina. Também possui uma ferramenta para realizar a triagem de nomes em grandes listas de sanções internacionais, incluindo os registros da UE, Reino Unido, ONU, OFAC, Suíça, Austrália e Canadá. Os usuários devem observar que as consultas consomem as cotas do plano da conta, enquanto as verificações de beneficiário utilizam créditos pré-pagos de Verification of Payee.
O que você pode fazer com ele
- 1Validar detalhes bancários internacionaisVerifique um IBAN para recuperar o banco, país e informações de BIC associados.
- 2Verificar routing numbers regionaisIdentifique o banco e a agência específicos associados a um código BSB australiano.
- 3Realizar triagem de sançõesVerifique um nome específico em listas de sanções globais para garantir a conformidade.
- 4Confirmar se o nome do beneficiário coincide com o IBANCompare o nome de uma pessoa com o titular de um IBAN europeu para evitar erros.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Fin Codes API
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP Fin Codes API no Claude Code
$ claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpInstalar o MCP Fin Codes API no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}Instalar o MCP Fin Codes API no VS Code
.vscode/mcp.json
{
"servers": {
"fincodesapi-mcp": {
"type": "http",
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}Instalar o MCP Fin Codes API no VS Code CLI
$ code --add-mcp '{"name":"fincodesapi-mcp","type":"http","url":"https://mcp.fincodesapi.com/mcp"}'Instalar o MCP Fin Codes API no Codex
$ codex mcp add fincodesapi-mcp --url https://mcp.fincodesapi.com/mcpInstalar o MCP Fin Codes API no Codex config.toml
~/.codex/config.toml
[mcp_servers.fincodesapi-mcp] url = "https://mcp.fincodesapi.com/mcp"
Instalar o MCP Fin Codes API no Gemini CLI
$ gemini mcp add -s user --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpInstalar o MCP Fin Codes API no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp",
"type": "http"
}
}
}Ferramentas do MCP Fin Codes API 11
Detectadas a partir do 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 | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelswiftcodesapi/fincodesapi-mcp is public and reachablegithub.com/swiftcodesapi/fincodesapi-mcp ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-10-29github.com/swiftcodesapi/fincodesapi-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPHTTPS endpoint answered 401 (sign-in required)Passou
README
Ver no GitHubFin 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.
Perguntas sobre o MCP Fin Codes API
Como adiciono o MCP Fin Codes API ao Claude Code?
Execute claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Fin Codes API ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP Fin Codes API oferece?
Ele expõe 11 ferramentas, incluindo lookup_iban, verify_iban_payee, lookup_bic, lookup_us_routing_number, lookup_canada_routing_number.
Como faço para me conectar ao MCP server do Fin Codes API?
Você pode adicionar o endpoint como um remote HTTP MCP server no seu cliente e fazer login via OAuth, ou usar uma API key para clientes que não possuem suporte a OAuth.
Quais ferramentas estão disponíveis neste server?
O server oferece onze ferramentas, incluindo validação de IBAN, resolução de BIC/SWIFT, consultas de routing numbers dos EUA, Canadá, Austrália, Índia, México e Argentina, além de triagem de sanções.
Posso usar este server sem uma conta?
Não, é necessário ter uma conta no Fin Codes API para usar o serviço, e as consultas consomem a cota do seu plano ou créditos pré-pagos.
Este server me permite transferir dinheiro?
Não, as ferramentas são apenas para consulta e verificação de dados; elas não executam transferências de dinheiro ou negociações.