diff --git a/pkg/mcp/add_transaction_tool_handler.go b/pkg/mcp/add_transaction_tool_handler.go
index b5061053..e747c6a4 100644
--- a/pkg/mcp/add_transaction_tool_handler.go
+++ b/pkg/mcp/add_transaction_tool_handler.go
@@ -33,8 +33,8 @@ type MCPAddTransactionRequest struct {
 
 // MCPAddTransactionResponse represents the response structure for add transaction
 type MCPAddTransactionResponse struct {
-	Success                   bool   `json:"success" jsonschema_description:"Indicates whether the transaction was added successfully"`
-	DryRun                    bool   `json:"dry_run,omitempty" jsonschema_description:"Indicates whether this is a dry run (transaction not saved actually)"`
+	Success                   bool   `json:"success" jsonschema_description:"Indicates whether this operation is successful"`
+	DryRun                    bool   `json:"dry_run,omitempty" jsonschema_description:"Indicates whether this operation is a dry run (transaction not saved actually)"`
 	AccountBalance            string `json:"account_balance,omitempty" jsonschema_description:"Account balance (or outstanding balance for debt accounts) after the transaction"`
 	DestinationAccountBalance string `json:"destination_account_balance,omitempty" jsonschema_description:"Destination account balance (or outstanding balance for debt accounts) after the transaction (only for transfer transactions)"`
 }
diff --git a/pkg/mcp/query_transactions_tool_handler.go b/pkg/mcp/query_transactions_tool_handler.go
index acd6c1ca..ed9bdc40 100644
--- a/pkg/mcp/query_transactions_tool_handler.go
+++ b/pkg/mcp/query_transactions_tool_handler.go
@@ -24,7 +24,7 @@ type MCPQueryTransactionsRequest struct {
 	Keyword               string `json:"keyword,omitempty" jsonschema_description:"Keyword to search in transaction description (optional)"`
 	Count                 int32  `json:"count,omitempty" jsonschema:"default=100" jsonschema_description:"Maximum number of results to return (default: 100)"`
 	Page                  int32  `json:"page,omitempty" jsonschema:"default=1" jsonschema_description:"Page number for pagination (default: 1)"`
-	ResponseFields        string `json:"response_fields,omitempty" jsonschema_description:"Comma-separated list of fields to include in the response (optional, leave empty for all fields, available fields: time, currency, category_name, account_name, comment)"`
+	ResponseFields        string `json:"response_fields,omitempty" jsonschema_description:"Comma-separated list of optional fields to include in the response (optional, leave empty for all fields, available fields: time, currency, category_name, account_name, comment)"`
 }
 
 // MCPQueryTransactionsResponse represents the response structure for querying transactions