Skip to main content

Add a new bank

The fastest path is to copy examples/demo (or one of the real-bank examples if you need authentication) and replace the handlers.

1. Copy a template​

cp -R examples/demo examples/yourbank
cd examples/yourbank

2. Rename the package​

Edit pyproject.toml:

[project]
name = "bank2ai-yourbank"
version = "0.1.0"

[project.scripts]
bank2ai-yourbank = "bank2ai_yourbank:main"

Rename the src/bank2ai_demo/ directory to src/bank2ai_yourbank/ and update imports.

If you're adding to the bank2ai workspace, register the package in the root pyproject.toml:

[tool.uv.workspace]
members = ["examples/demo", "examples/yourbank"]

[tool.uv.sources]
bank2ai-yourbank = { workspace = true }

3. Replace the handlers​

In server.py, replace the demo handlers with calls into your bank's APIs. You don't need to redefine any schemas, register_tools lives in bank2ai and is fixed by the spec.

from bank2ai import register_tools
from .acme_client import AcmeBankClient

api = AcmeBankClient(...)

async def get_accounts(*, only_withdrawal_accounts, account_type):
    return await _list_accounts_via_acme(api, only_withdrawal_accounts, account_type)

# … any other handlers you implement …

register_tools(app, get_accounts=get_accounts, ...)

Every register_tools keyword argument is optional, so you can land tools incrementally, start with get-accounts and add the rest as the backend integration matures.

See Writing handlers for patterns and Wrap a real bank for a worked example.

4. Test it​

5. Publish to the marketplace​

Once your server is solid, publish it as a Claude Code plugin so any client can install it with one command.