MCP server for Alfa-Bank Business (Alfa API) — accounts, statements, payments, beneficiaries, rates, payroll (Russia)
8 tools with clear verb-noun naming (list_, get_, create_). All have descriptions (avg 150 chars, within baseline 34-392). Input schemas present with typed parameters and descriptions. Tool annotations (destructive hint on create_payment_order) correctly applied. Key gaps: output schemas not documented in code; error handling lacks recovery guidance; no pagination support on list tools despite potential for large result sets.
Create a new payment order in Alfa-Bank (moves real money). Transfers funds from one account to another using BIK and account number. Note: the production API submits payments as a SIGNED registry — this requires a PKCS#7 GOST signature (see README); without an injected signer it returns a clear error explaining what is needed.
Get the current balance of a specific Alfa-Bank business account by its ID.
Get account statement (transactions) for a date range. Returns credits, debits, opening/closing balance.
Get current currency exchange rates from Alfa-Bank, including buy/sell rates and Central Bank rate.
Check the status of a previously created payment order by its ID.
Output schemas not documented. Tool descriptions state what is returned (e.g. 'Returns account numbers, currencies, types, and statuses') but no formal schema is visible in code. LLMs cannot plan downstream tool calls without knowing response structure.
List tools (list_accounts, list_counterparties, get_salary_registry) lack pagination parameters (limit, offset, page_size). No indication of result caps. If Alfa API returns hundreds of accounts or counterparties, responses could exhaust context window.
Error handling lacks recovery guidance. Code mentions 'returns a clear error explaining what is needed' for GOST signature, but no evidence of structured error responses with actionable next steps (e.g. 'Try calling X first' or 'Retry with Y parameter').
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | <=2025-11-25 | v2 |
Get payroll (salary) registries from Alfa-Bank. Returns registry status, total amount, and employee count.
List all business accounts in Alfa-Bank. Returns account numbers, currencies, types, and statuses.
List all saved counterparties (business partners / beneficiaries) in Alfa-Bank. Returns names, INN, KPP, BIK, and account numbers.
get_account_statement parameters (date_from, date_to) lack format validation hints in descriptions. Should specify 'YYYY-MM-DD format' explicitly (currently stated in description but not as a constraint/pattern).
create_payment_order amount parameter lacks bounds. Description says 'minor units (kopeks)' but no min/max specified. Unbounded numeric parameters invite LLM errors (e.g. passing 999999999999).