Skip to main content
Glama
swiftcodesapi

Fin Codes API MCP server

Official
by swiftcodesapi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

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.

Related MCP server: ibanchecker-mcp

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • IBANforge

    cammac-creator
    A
    license
    A
    quality
    B
    maintenance
    IBAN validation across 89 countries, BIC/SWIFT and Swiss clearing lookup, batch validation, payment-reference, postal-address and Swiss QR-bill checks for AI agents. Connect via MCP or the REST API. Includes free quotas, paid credits and a Pro subscription. SEPA and country-risk indicators support payment-data checks; they do not confirm account ownership or replace beneficiary AML/KYC screening.
    13
    227 npm
    3
    MIT

  • ibanchecker-mcp

    koraykoylu
    A
    license
    A
    quality
    A
    maintenance
    IBAN validation, extraction, format specs, and BIC/SWIFT lookup tools for AI assistants, backed by ibanchecker.cash. Covers 90 countries; no IBAN data is stored.
    5
    30 npm
    MIT

  • MCP-valider_iban

    peonixo147
    F
    license
    Not graded
    quality
    B
    maintenance
    Validates International Bank Account Numbers (IBANs) through a Cloudflare-hosted MCP server, enabling agents to check IBAN validity via natural language.
    -

  • ibangen-mcp

    offx366
    A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to validate IBANs, generate synthetic checksum-valid test IBANs, and look up bank registry records by BIC or domestic identifier, with optional paid capabilities for bank, BIC, and SEPA Instant/VoP reachability.
    3
    34 PyPI
    MIT