Loading ToolBench

Reading the current corpus…

smartportfel-web-open-source MCP server · D · ToolBench

smartportfel-web-open-source

github.com/fisieek/smartportfel-web-open-source

MCP server for SmartPortfel personal finance management system. Provides tools for managing transactions, accounts, investments, savings, and financial planning with two-step transaction validation (preview + commit).

2026-07-28+STREAMABLE_HTTP4 tools

56/100

Definition Quality52

Protocol Readiness65

SupportabilityNot measured-

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence · detected: Dynamic Client Registration

Deprecated protocol patterns detected

Summary

SmartPortfel MCP server has 4 tools with Polish-language descriptions and basic schemas. Tool names follow verb_noun pattern (preview_, commit_, get_). However, descriptions are minimal (20-80 chars), lack actionable context, and parameter descriptions are sparse or missing. Input schemas are present but incomplete: many parameters lack descriptions, and output schemas are not documented. Error handling is absent. The preview/commit pattern is sound but underdocumented. No evidence of idempotency hints, permission gates, or recovery guidance.

Tools (4)

commit_transactionswriteauthsource verified52/100

Zapisuje pozycje zwrócone wcześniej przez preview_transactions (pole "items"). Wywołuj WYŁĄCZNIE po potwierdzeniu przez użytkownika.

get_accountsread onlyauthsource verified52/100

Zwraca konta osobiste użytkownika z saldami.

get_monthly_summaryread onlyauthsource verified52/100

Wydatki i wpływy w bieżącym miesiącu.

preview_transactionsread onlyauthsource verified52/100

Parsuje i rozwiązuje listę wydatków/wpływów (konto, sklep→kategoria, data) BEZ zapisu. Zwróć wynik użytkownikowi do potwierdzenia, a po akceptacji wywołaj commit_transactions z polem "items" z odpowiedzi.

Issues (5)

HIGHtool-description ↗

Descriptions are too brief (20 - 80 chars) and lack actionable context. 'Zwraca konta osobiste użytkownika z saldami' does not explain WHEN to call this tool, what fields are returned, or how to use the result in downstream calls.

get_accountsget_monthly_summary

HIGHtool-description ↗

Parameter descriptions are missing or minimal. 'amount' has a description, but 'store', 'date', 'accountName', 'note' lack context. LLMs cannot infer whether 'store' is a free-form string, a reference to a predefined list, or a category ID.

preview_transactionscommit_transactions

HIGHresponse-shaper ↗

Output schemas are not documented. The preview_transactions tool returns 'items' but the structure of each item is not specified. LLMs cannot plan downstream calls or extract required fields without seeing the response schema.

preview_transactionscommit_transactionsget_accountsget_monthly_summary

Recommendations

Expand tool descriptions to 100 - 200 characters. For get_accounts, add: 'Returns the user's personal accounts with current balances and account IDs. Use this to resolve account names to IDs before calling preview_transactions or commit_transactions.'
Add descriptions to all parameters. For 'store' in preview_transactions: 'Store or source name (e.g., "Biedronka", "Carrefour", "Salary"). Will be resolved to a category automatically.' For 'date': 'Transaction date in ISO 8601 format (YYYY-MM-DD). Defaults to today if omitted.'
Document output schemas for all tools. E.g., preview_transactions returns: {items: [{amount, type, store, date, accountId, accountName, categoryId, categoryName, note}]}. This enables LLMs to chain calls correctly.
Add error handling with recovery hints. E.g., 'Store "XYZ" not recognized. Call get_accounts() to see available accounts, or provide a valid store name from your transaction history.'
Add a 'dry_run' parameter to commit_transactions (boolean, default false) to allow agents to preview the commit without persisting data. Or document that preview_transactions must always be called first and the user must confirm before commit.

Score history

Overall score trend

First recorded score · v2 rubric

56/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	D	56	2026-07-28+	v2