MCP server de Fin Codes API
Commit 29 oct 2026Valida IBAN, códigos bancarios y nombres de beneficiarios mientras realizas el filtrado de personas contra listas de sanciones globales.
También conocido como swiftcodesapi/fincodesapi-mcp, fincodesapi-mcp
- Stars
- 0
- Herramientas
- 11
- Descargas, 30 días
- —
- Última versión
- 1.0.1
- Último commit
- 29 oct 2026
- Licencia
- MIT
¿Qué es Fin Codes API MCP?
Fin Codes API es un MCP server. Valida IBAN, códigos bancarios y nombres de beneficiarios mientras realizas el filtrado de personas contra listas de sanciones globales. Expone 11 herramientas, como lookup_iban, verify_iban_payee, lookup_bic.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Fin Codes API
Fin Codes API ofrece un remote MCP server que conecta asistentes de IA con datos de referencia bancaria global y herramientas de cumplimiento. Los desarrolladores pueden integrar este servicio en clientes como Claude Code, VS Code, Cursor, Cline y Gemini CLI utilizando transporte streamable HTTP. El server requiere una cuenta de Fin Codes API, que puede autenticarse mediante OAuth o a través de una API key creada manualmente para los clientes que no admiten OAuth.
El server proporciona once herramientas especializadas para la validación de datos financieros y seguridad. Estas incluyen funciones para buscar IBAN, detalles de BIC/SWIFT y diversos números de ruta regionales para EE. UU., Canadá, Australia, Nueva Zelanda, India, México y Argentina. También cuenta con una herramienta para filtrar nombres contra las principales listas de sanciones internacionales, incluyendo los registros de la UE, Reino Unido, ONU, OFAC, Suiza, Australia y Canadá. Los usuarios deben tener en cuenta que las búsquedas consumen la cuota del plan de la cuenta, mientras que las verificaciones de beneficiarios utilizan créditos prepagados de Verification of Payee.
Qué puedes hacer con él
- 1Validar detalles bancarios internacionalesVerifica un IBAN para obtener su banco, país y la información BIC asociados.
- 2Verificar números de ruta regionalesIdentifica el banco y la sucursal específicos asociados a un código BSB australiano.
- 3Realizar filtrado de sancionesComprueba un nombre específico contra listas de sanciones globales para garantizar el cumplimiento normativo.
- 4Confirmar que el nombre del beneficiario coincida con el IBANCompara el nombre de una persona con el titular de un IBAN europeo para evitar errores.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Fin Codes API MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Fin Codes API MCP en Claude Code
$ claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpInstalar Fin Codes API MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}Instalar Fin Codes API MCP en VS Code
.vscode/mcp.json
{
"servers": {
"fincodesapi-mcp": {
"type": "http",
"url": "https://mcp.fincodesapi.com/mcp"
}
}
}Instalar Fin Codes API MCP en VS Code CLI
$ code --add-mcp '{"name":"fincodesapi-mcp","type":"http","url":"https://mcp.fincodesapi.com/mcp"}'Instalar Fin Codes API MCP en Codex
$ codex mcp add fincodesapi-mcp --url https://mcp.fincodesapi.com/mcpInstalar Fin Codes API MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.fincodesapi-mcp] url = "https://mcp.fincodesapi.com/mcp"
Instalar Fin Codes API MCP en Gemini CLI
$ gemini mcp add -s user --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcpInstalar Fin Codes API MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fincodesapi-mcp": {
"url": "https://mcp.fincodesapi.com/mcp",
"type": "http"
}
}
}Herramientas de Fin Codes API MCP 11
Detectado desde el 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 | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleswiftcodesapi/fincodesapi-mcp is public and reachablegithub.com/swiftcodesapi/fincodesapi-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-29github.com/swiftcodesapi/fincodesapi-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en 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.
Preguntas sobre Fin Codes API MCP
¿Cómo agrego Fin Codes API MCP a Claude Code?
Ejecuta claude mcp add --transport http fincodesapi-mcp https://mcp.fincodesapi.com/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Fin Codes API MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Fin Codes API MCP?
Expone 11 herramientas, incluidas lookup_iban, verify_iban_payee, lookup_bic, lookup_us_routing_number, lookup_canada_routing_number.
¿Cómo me conecto al MCP server de Fin Codes API?
Puedes añadir el endpoint como un remote HTTP MCP server en tu cliente e iniciar sesión mediante OAuth, o usar una API key si utilizas clientes que no admiten OAuth.
¿Qué herramientas están disponibles en este server?
El server ofrece once herramientas que incluyen validación de IBAN, resolución de BIC/SWIFT, búsquedas de números de ruta de EE. UU., Canadá, Australia, India, México y Argentina, y filtrado de sanciones.
¿Puedo usar este server sin una cuenta?
No, es necesario tener una cuenta de Fin Codes API para usar el servicio, y las búsquedas consumen la cuota de tu plan o créditos prepagados.
¿Este server me permite transferir dinero?
No, las herramientas son solo para la consulta y verificación de datos; no ejecutan transferencias de dinero ni operaciones comerciales.