@albertomarturelo/cta-mcp
v0.3.1
Published
MCP (stdio) server to read your own Chilean bank accounts from an AI agent. Each tool is a thin call into @albertomarturelo/cta-core tasks (ADR-003).
Downloads
1,014
Maintainers
Readme
@albertomarturelo/cta-mcp
cta-mcp: a stdio MCP server that lets an AI
agent (Claude Desktop, Claude Code, any MCP client) read your own Chilean bank
accounts — balances and movements. A thin surface over
@albertomarturelo/cta-core.
⚠️ 0.x and unofficial. Not affiliated with, sponsored or endorsed by any bank. Automating access to your own account may breach your bank's terms, and the bank may block your access or your device. Provided "as is", without warranty (MIT). Read-only: it never moves money.
No tool accepts a password: login happens in a browser window where you type your
credentials yourself. The login tool returns as soon as the window opens.
Install
npm i -g @albertomarturelo/cta-mcp
npx playwright install chromium
cta-mcp --versionRequires Node ≥ 20. Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"cta": { "command": "cta-mcp" }
}
}Tools
bancos, login, logout, cuentas, saldo, movimientos, tarjetas. Every bank-scoped
tool takes a required banco, e.g. "bci".
Demo bank
Set CTA_DEMO=1 ("env": { "CTA_DEMO": "1" } in the server entry) to add a
fictitious bank, banco: "demo": two accounts, about six weeks of movements and
two credit cards, all invented and dated relative to today. Its login opens a
local demo page; press «Ingresar». Nothing reaches a bank.
BCI flow
loginwithbanco: "bci"opens the bank's page. Log in there.- Once you reach your bank home, the window closes within seconds: cta takes the read session the bank hands its own web, clicking nothing. The server holds that session in memory, never on disk, for about an hour.
bancosshowssesionHasta. Until then,cuentas,saldo,movimientosandtarjetasread over HTTP, with no browser. After it, log in again.
If the bank blocks a read, the tool returns the bank's message and nothing is retried. See the roadmap.
