Skip to main content

​
MCP Tools Overview

AI2Fin MCP provides 47 tools across 11 categories for comprehensive financial management.
All tools enforce user-isolation - you can only access your own data.

​
📊 Tool Categories

Transactions

10 toolsQuery, create, and analyze spending activity

Bills

10 toolsRecurring bill patterns, payments, and FY analysis

Custom Rules

6 toolsLow-code automation for categorization and compliance

Expenses

1 toolManual expense entry with rule execution

Travel

5 toolsVehicle registry, trip logging, deduction summaries

User Profile

2 toolsPreferences, locale, and AI context updates

Subscription

2 toolsPlan status checks and feature gates

Receipts

2 toolsReceipt ingestion, AI extraction, and linking

AI Analysis

3 toolsCategorization, tax analysis, and update helpers

Spending Outlook

1 toolBlend actual spend with projected bills

Budgets

5 tools (Coming Soon)Budget creation, tracking, and alerts

​
🚀 Quick Tool Reference

​
Transaction Tools (10)

ToolPurposeStatus
get_transactionsQuery with filters✅
get_tax_deductible_summaryTax summary by category✅
create_transactionAdd transaction✅
trigger_smart_categorizationAI categorization✅
get_category_spending_summaryNEW Spending breakdown✅
get_top_merchantsNEW Top vendors✅
compare_spending_periodsNEW Period comparison✅
bulk_categorize_transactionsNEW Batch categorization✅
bulk_update_transactionsNEW Batch updates✅
find_duplicate_transactionsNEW Duplicate detection✅

​
Bill Tools (10)

ToolPurposeStatus
get_billsList bill patterns✅
get_upcoming_billsFuture bills✅
get_bill_summaryMonthly totals✅
get_bill_occurrencesNEW Historical queries✅
get_overdue_billsNEW Overdue bills✅
get_bill_pattern_financial_summaryNEW FY analysis✅
mark_bill_as_paidNEW Payment tracking✅
upload_receipt_for_billNEW Receipt linking✅
create_bill_patternNEW Manual creation✅
update_bill_patternNEW Update pattern✅

​
Custom Rules (6)

ToolPurposeStatus
get_rulesList rules✅
create_ruleCreate automation✅
update_ruleUpdate rule✅
delete_ruleRemove rule✅
enable_ruleToggle rule✅
test_ruleTest before saving✅

​
Travel Tools (5)

ToolPurposeStatus
get_travel_profileTravel settings✅
get_vehiclesRegistered vehicles✅
get_tripsTrip history✅
create_tripLog trip✅
get_travel_deduction_summaryTax deductions✅

​
User Profile Tools (2)

ToolPurposeStatus
get_user_profileFetch preferences, locale, and AI context✅
set_user_preferencesUpdate country, business type, industry, AI context✅

​
Subscription Tools (2)

ToolPurposeStatus
get_user_subscriptionRetrieve plan tier and quotas✅
check_feature_accessVerify gated features (e.g., AI analysis)✅

​
Expense Tools (1)

ToolPurposeStatus
create_expenseCreate expense and apply custom rules✅

​
Receipt Tools (2)

ToolPurposeStatus
analyze_receiptRun AI extraction on uploaded receipt✅
commit_receiptLink receipt to transaction or create expense✅

​
AI Analysis Tools (3)

ToolPurposeStatus
analyze_transaction_categorizationSuggest category with AI reasoning✅
analyze_transaction_tax_deductibilityEvaluate deductibility, business %, GST✅
apply_analysis_to_transactionPersist AI results (category, tax, GST)✅

​
Spending Outlook (1)

ToolPurposeStatus
get_spending_outlookBlend actual spend with upcoming bill projections✅

​
Budgets (5)

ToolPurposeStatus
create_budgetBudget creation⏳
get_budgetsRetrieve budgets⏳
get_budget_statusBudget vs actual⏳
update_budgetModify budget⏳
delete_budgetRemove budget⏳

​
🆕 Recent Additions (Nov 2025)

get_category_spending_summary
Analyze spending breakdown by categoryget_top_merchants
Rank merchants by total spendcompare_spending_periods
Period-over-period comparison
bulk_categorize_transactions
Batch categorization by merchantbulk_update_transactions
Update multiple fields at oncefind_duplicate_transactions
Detect duplicate payments
get_bill_occurrences
Flexible historical queriesget_overdue_bills
Overdue bill detectionget_bill_pattern_financial_summary
FY-aware analysis with projectionsmark_bill_as_paid
Payment trackingupload_receipt_for_bill
Receipt linkingcreate_bill_pattern
Manual bill creationupdate_bill_pattern
Pattern management
analyze_transaction_categorization
AI category suggestions with reasoninganalyze_transaction_tax_deductibility
Tax analysis with documentation guidanceapply_analysis_to_transaction
Persist accepted AI results (category, tax, GST)
analyze_receipt
Extract totals, GST, merchants, and candidatescommit_receipt
Link receipts to transactions or create expenses
get_spending_outlook
Combine actual spend with projected bills

​
🎯 Common Use Cases

​
”Show me my spending breakdown”

→ get_category_spending_summary

​
”Where do I spend the most?”

→ get_top_merchants

​
”Did I spend more this month vs last?”

→ compare_spending_periods

​
”Categorize all Uber as Transport”

→ bulk_categorize_transactions

​
”What are my overdue bills?”

→ get_overdue_bills

​
”How much have I paid for Netflix this FY?”

→ get_bill_pattern_financial_summary

​
”Mark Netflix as paid”

→ mark_bill_as_paid

​
”Did I pay this bill twice?”

→ find_duplicate_transactions

​
🔐 Security & Performance

​
User Isolation

  • All queries filtered by userId
  • No cross-user data access
  • Enforced at database level

​
Performance

  • Direct database access (no HTTP overhead)
  • Response times: 5-200ms typical
  • Efficient bulk operations

​
Data Privacy

  • No raw data exposed to AI
  • Cached analysis only
  • Secure authentication required

​
📚 Next Steps

Transaction Tools

Detailed transaction API docs

Bill Tools

Bill management API docs

Examples

Real-world usage examples

Authentication

Setup & authentication