MCP server for FIO Bank API (Czech Republic)
npm install fio-bank-mcpAn MCP (Model Context Protocol) server for FIO Bank API in the Czech Republic. Allows AI assistants like Claude to access FIO Bank account transactions.
``bash`
pnpm install
pnpm build
1. Log in to your FIO Bank internet banking
2. Go to Settings → API
3. Create a new token (requires SMS or push notification)
4. Wait 5 minutes before using the token
- Each token is valid for one account only
- Maximum validity: 180 days
- Can auto-renew on each login to internet banking
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
`json`
{
"mcpServers": {
"fio-bank": {
"command": "node",
"args": ["/path/to/fio-bank-mcp/dist/index.js"],
"env": {
"FIO_API_TOKEN": "your-64-character-token-here"
}
}
}
}
Get account transactions for a specific date range.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| dateFrom | string | Yes | Start date (YYYY-MM-DD) |dateTo
| | string | Yes | End date (YYYY-MM-DD) |token
| | string | No | API token (uses FIO_API_TOKEN env var if not provided) |
Returns:
- Account info (IBAN, BIC, balance)
- List of transactions with:
- Transaction ID, date, amount, currency
- Counter account (number, name, bank)
- Payment symbols (variable, constant, specific)
- Message for recipient, comments
- Transaction type
Use the MCP Inspector to test the server with a web UI:
`bash`
npx @modelcontextprotocol/inspector node dist/index.js
This opens a browser where you can see available tools, call them with parameters, and view responses.
To pass the API token:
`bash`
FIO_API_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/index.js
1 request per 30 seconds per token. The server automatically waits if needed.
- Data up to 90 days old: accessible immediately
- Data older than 90 days: requires temporary unlock in internet banking (Settings → API → click lock icon, valid for 10 minutes)
| Code | Description |
|------|-------------|
| 404 | Invalid URL or token |
| 409 | Rate limit exceeded (wait 30 seconds) |
| 413 | Too many transactions in response |
| 422 | Invalid request data |
| 500 | Internal server error |
`bash``
pnpm install # Install dependencies
pnpm build # Build TypeScript
pnpm lint # Run ESLint
pnpm typecheck # Type check without emitting
- FIO Bank API Documentation (Czech)
- MCP Protocol
MIT