> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai2fin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools Catalog — 65+ Financial Tools for AI Assistants

> Browse the full catalog of 65+ AI2Fin MCP tools organized across 18 categories including transactions, bills, categories, and tax analysis.

# MCP Tools Overview

AI2Fin MCP provides **65+ tools** across 18 categories for comprehensive financial management.

<Note>
  All tools enforce **user-isolation** - you can only access your own data.
</Note>

***

## 📊 Tool Categories

<CardGroup cols={3}>
  <Card title="Transactions" icon="list" iconType="solid">
    **9 tools**

    Query, create, and analyze spending activity
  </Card>

  <Card title="Bills" icon="calendar" iconType="solid">
    **10 tools**

    Recurring bill patterns, payments, and FY analysis
  </Card>

  <Card title="Custom Rules" icon="wand-magic-sparkles" iconType="solid">
    **6 tools**

    Low-code automation for categorization and compliance
  </Card>

  <Card title="Expenses" icon="receipt" iconType="solid">
    **1 tool**

    Manual expense entry with rule execution
  </Card>

  <Card title="Travel" icon="car" iconType="solid">
    **6 tools**

    Vehicle registry, trip logging, deduction summaries
  </Card>

  <Card title="User Profile" icon="user" iconType="solid">
    **2 tools**

    Preferences, locale, and AI context updates
  </Card>

  <Card title="Subscription" icon="credit-card" iconType="solid">
    **2 tools**

    Plan status checks and feature gates
  </Card>

  <Card title="Receipts" icon="file-image" iconType="solid">
    **2 tools**

    Receipt ingestion, AI extraction, and linking
  </Card>

  <Card title="AI Analysis" icon="brain" iconType="solid">
    **3 tools**

    Categorization, tax analysis, and update helpers
  </Card>

  <Card title="Spending Outlook" icon="chart-line" iconType="solid">
    **1 tool**

    Blend actual spend with projected bills
  </Card>

  <Card title="Budgets" icon="piggy-bank" iconType="solid">
    **5 tools** (Coming Soon)

    Budget creation, tracking, and alerts
  </Card>

  <Card title="Enhanced Workflows" icon="sitemap" iconType="solid">
    **4 tools**

    Link transactions to bills, suggest patterns, auto-linking
  </Card>

  <Card title="Bulk Operations Enhanced" icon="layer-group" iconType="solid">
    **3 tools**

    Bulk tax analysis, bulk bill marking, bulk trip linking
  </Card>

  <Card title="Smart Suggestions" icon="lightbulb" iconType="solid">
    **3 tools**

    Budget suggestions, rule suggestions, tax deduction suggestions
  </Card>

  <Card title="Relationships" icon="sitemap" iconType="solid">
    **4 tools**

    Transaction relationships, bill transactions, trip transactions, receipts
  </Card>

  <Card title="Smart Receipt Processor" icon="file-image" iconType="solid">
    **1 tool**

    One-call receipt processing workflow
  </Card>

  <Card title="File Upload" icon="upload" iconType="solid">
    **1 tool**

    CSV/Excel file upload and processing
  </Card>

  <Card title="Bulk Operations" icon="tasks" iconType="solid">
    **3 tools**

    Bulk categorization, bulk updates, duplicate detection
  </Card>
</CardGroup>

***

## 🚀 Quick Tool Reference

### Transaction Tools (9)

| Tool                                  | Purpose                          | Status |
| ------------------------------------- | -------------------------------- | ------ |
| `get_transactions`                    | Query with filters               | ✅      |
| `get_tax_deductible_summary`          | Tax summary by category          | ✅      |
| `get_category_spending_summary`       | Spending breakdown by category   | ✅      |
| `get_top_merchants`                   | Top vendors by spending          | ✅      |
| `compare_spending_periods`            | Period comparison                | ✅      |
| `get_spending_analytics`              | Comprehensive spending analytics | ✅      |
| `search_transactions_by_intelligence` | AI-powered transaction search    | ✅      |
| `create_transaction`                  | Add transaction                  | ✅      |
| `trigger_smart_categorization`        | AI categorization                | ✅      |

### Bill Tools (10)

| Tool                                 | Purpose                    | Status |
| ------------------------------------ | -------------------------- | ------ |
| `get_bills`                          | List bill patterns         | ✅      |
| `get_upcoming_bills`                 | Future bills               | ✅      |
| `get_bill_summary`                   | Monthly totals             | ✅      |
| `get_bill_occurrences`               | **NEW** Historical queries | ✅      |
| `get_overdue_bills`                  | **NEW** Overdue bills      | ✅      |
| `get_bill_pattern_financial_summary` | **NEW** FY analysis        | ✅      |
| `mark_bill_as_paid`                  | **NEW** Payment tracking   | ✅      |
| `upload_receipt_for_bill`            | **NEW** Receipt linking    | ✅      |
| `create_bill_pattern`                | **NEW** Manual creation    | ✅      |
| `update_bill_pattern`                | **NEW** Update pattern     | ✅      |

### Custom Rules (6)

| Tool          | Purpose            | Status |
| ------------- | ------------------ | ------ |
| `get_rules`   | List rules         | ✅      |
| `create_rule` | Create automation  | ✅      |
| `update_rule` | Update rule        | ✅      |
| `delete_rule` | Remove rule        | ✅      |
| `enable_rule` | Toggle rule        | ✅      |
| `test_rule`   | Test before saving | ✅      |

### Travel Tools (6)

| Tool                           | Purpose             | Status |
| ------------------------------ | ------------------- | ------ |
| `get_travel_profile`           | Travel settings     | ✅      |
| `get_vehicles`                 | Registered vehicles | ✅      |
| `get_trips`                    | Trip history        | ✅      |
| `create_trip`                  | Log trip            | ✅      |
| `update_trip`                  | Update trip details | ✅      |
| `get_travel_deduction_summary` | Tax deductions      | ✅      |

### User Profile Tools (2)

| Tool                   | Purpose                                             | Status |
| ---------------------- | --------------------------------------------------- | ------ |
| `get_user_profile`     | Fetch preferences, locale, and AI context           | ✅      |
| `set_user_preferences` | Update country, business type, industry, AI context | ✅      |

### Subscription Tools (2)

| Tool                    | Purpose                                   | Status |
| ----------------------- | ----------------------------------------- | ------ |
| `get_user_subscription` | Retrieve plan tier and quotas             | ✅      |
| `check_feature_access`  | Verify gated features (e.g., AI analysis) | ✅      |

### Expense Tools (1)

| Tool             | Purpose                               | Status |
| ---------------- | ------------------------------------- | ------ |
| `create_expense` | Create expense and apply custom rules | ✅      |

### Receipt Tools (2)

| Tool              | Purpose                                       | Status |
| ----------------- | --------------------------------------------- | ------ |
| `analyze_receipt` | Run AI extraction on uploaded receipt         | ✅      |
| `commit_receipt`  | Link receipt to transaction or create expense | ✅      |

### AI Analysis Tools (3)

| Tool                                    | Purpose                                                                    | Status |
| --------------------------------------- | -------------------------------------------------------------------------- | ------ |
| `analyze_transaction_categorization`    | Suggest a category with clear reasoning                                    | ✅      |
| `analyze_transaction_tax_deductibility` | Check whether an expense is tax deductible, including business use and GST | ✅      |
| `apply_analysis_to_transaction`         | Apply the accepted category and tax details to a transaction               | ✅      |

### Spending Outlook (1)

| Tool                   | Purpose                                           | Status |
| ---------------------- | ------------------------------------------------- | ------ |
| `get_spending_outlook` | Blend actual spend with upcoming bill projections | ✅      |

### Bulk Operations (3)

| Tool                           | Purpose                          | Status |
| ------------------------------ | -------------------------------- | ------ |
| `bulk_categorize_transactions` | Batch categorization by merchant | ✅      |
| `bulk_update_transactions`     | Update multiple fields at once   | ✅      |
| `find_duplicate_transactions`  | Detect duplicate payments        | ✅      |

### Enhanced Workflows (4)

| Tool                                 | Purpose                                  | Status |
| ------------------------------------ | ---------------------------------------- | ------ |
| `link_transaction_to_bill`           | Link transaction to bill pattern         | ✅      |
| `suggest_bill_patterns`              | Suggest bill patterns from transactions  | ✅      |
| `auto_link_transactions_to_bills`    | Automatically link transactions to bills | ✅      |
| `mark_bill_as_paid_with_transaction` | Mark bill as paid and create transaction | ✅      |

### Bulk Operations Enhanced (3)

| Tool                              | Purpose                               | Status |
| --------------------------------- | ------------------------------------- | ------ |
| `bulk_analyze_tax_deductibility`  | Analyze multiple transactions for tax | ✅      |
| `bulk_mark_bills_as_paid`         | Mark multiple bills as paid           | ✅      |
| `bulk_link_transactions_to_trips` | Link multiple transactions to trips   | ✅      |

### Smart Suggestions (3)

| Tool                     | Purpose                          | Status |
| ------------------------ | -------------------------------- | ------ |
| `suggest_budgets`        | Get budget recommendations       | ✅      |
| `suggest_rules`          | Get custom rule suggestions      | ✅      |
| `suggest_tax_deductions` | Find tax deduction opportunities | ✅      |

### Relationships (4)

| Tool                            | Purpose                            | Status |
| ------------------------------- | ---------------------------------- | ------ |
| `get_transaction_relationships` | Get related transactions           | ✅      |
| `get_bill_transactions`         | Get transactions linked to bill    | ✅      |
| `get_trip_transactions`         | Get transactions linked to trip    | ✅      |
| `get_transaction_receipts`      | Get receipts linked to transaction | ✅      |

### Smart Receipt Processor (1)

| Tool                      | Purpose                              | Status |
| ------------------------- | ------------------------------------ | ------ |
| `smart_receipt_processor` | One-call receipt processing workflow | ✅      |

### File Upload (1)

| Tool                  | Purpose                              | Status |
| --------------------- | ------------------------------------ | ------ |
| `upload_expense_file` | Upload CSV/Excel file for processing | ✅      |

### Budgets (5) <Badge text="Coming Soon" variant="warning" />

| Tool                | Purpose          | Status |
| ------------------- | ---------------- | ------ |
| `create_budget`     | Budget creation  | ⏳      |
| `get_budgets`       | Retrieve budgets | ⏳      |
| `get_budget_status` | Budget vs actual | ⏳      |
| `update_budget`     | Modify budget    | ⏳      |
| `delete_budget`     | Remove budget    | ⏳      |

***

## 🆕 Recent Additions (Nov 2025)

<AccordionGroup>
  <Accordion title="Analytics Tools (3)" icon="chart-line">
    **`get_category_spending_summary`**\
    Analyze spending breakdown by category

    **`get_top_merchants`**\
    Rank merchants by total spend

    **`compare_spending_periods`**\
    Period-over-period comparison
  </Accordion>

  <Accordion title="Bulk Operations (3)" icon="layer-group">
    **`bulk_categorize_transactions`**\
    Batch categorization by merchant

    **`bulk_update_transactions`**\
    Update multiple fields at once

    **`find_duplicate_transactions`**\
    Detect duplicate payments
  </Accordion>

  <Accordion title="Bill Management (7)" icon="calendar-check">
    **`get_bill_occurrences`**\
    Flexible historical queries

    **`get_overdue_bills`**\
    Overdue bill detection

    **`get_bill_pattern_financial_summary`**\
    FY-aware analysis with projections

    **`mark_bill_as_paid`**\
    Payment tracking

    **`upload_receipt_for_bill`**\
    Receipt linking

    **`create_bill_pattern`**\
    Manual bill creation

    **`update_bill_pattern`**\
    Pattern management
  </Accordion>

  <Accordion title="AI Analysis (3)" icon="brain">
    **`analyze_transaction_categorization`**\
    AI category suggestions with reasoning

    **`analyze_transaction_tax_deductibility`**\
    Tax-deductibility check with documentation guidance

    **`apply_analysis_to_transaction`**\
    Apply the accepted category and tax details to a transaction
  </Accordion>

  <Accordion title="Receipt Automation (2)" icon="file-image">
    **`analyze_receipt`**\
    Reads totals, GST, and merchant from a receipt and finds the likely matching transaction

    **`commit_receipt`**\
    Link receipts to transactions or create expenses
  </Accordion>

  <Accordion title="Spending Outlook (1)" icon="chart-line">
    **`get_spending_outlook`**\
    Combine actual spend with projected bills
  </Accordion>
</AccordionGroup>

***

## 🎯 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

### Account Isolation

* Every tool is scoped to your authenticated account
* No cross-account data access
* Requests can only read or write your own data

### Performance

* Fast, low-latency responses
* Efficient bulk operations for large datasets

### Data Privacy

* Data is encrypted in transit (TLS) and at rest
* You control your data and can export or delete it at any time
* Secure authentication is required for every request

***

## 📚 Next Steps

<CardGroup cols={2}>
  <Card title="Transaction Tools" icon="list" href="/mcp/transaction-tools">
    Detailed transaction API docs
  </Card>

  <Card title="Bill Tools" icon="calendar" href="/mcp/bill-tools">
    Bill management API docs
  </Card>

  <Card title="Examples" icon="code" href="/mcp/examples">
    Real-world usage examples
  </Card>

  <Card title="Authentication" icon="key" href="/mcp/authentication">
    Setup & authentication
  </Card>
</CardGroup>