# Clara MCP Server

This is the Model Context Protocol (MCP) server for Clara, your personal AI financial assistant. It securely proxies requests to your Personal Expense Tracker backend using your unique API Key.

## Security Architecture

The MCP Server **does not** connect directly to your database. Instead, it acts as an authenticated REST Proxy:
1. It reads your `CLARA_API_KEY` from your local environment.
2. It sends standard HTTP requests to your web application's API.
3. Your web application validates the API key, ensures you are only accessing your own data, and securely performs the database operations.

## Configuration

To use this MCP Server in your IDE (like Cursor, Windsurf, or Antigravity), you must provide two environment variables.

1. Go to your Personal Expense Tracker -> **Settings**.
2. Under **Clara AI Assistant**, click **Generate** to create a Clara API Key.
3. Add the following to your IDE's MCP Configuration:

```json
{
  "mcpServers": {
    "clara": {
      "command": "node",
      "args": ["/path/to/clara-mcp-server/index.js"],
      "env": {
        "CLARA_API_KEY": "YOUR_GENERATED_API_KEY",
        "CLARA_API_URL": "http://localhost:3000/api"
      }
    }
  }
}
```

*(Note: Change `CLARA_API_URL` to your production URL if you deploy your web app, e.g., `https://my-expense-tracker.com/api`)*

## Available Tools

- `list_transactions`: View recent income and expenses.
- `add_transaction`: Log a new transaction.
- `delete_transaction`: Remove an existing transaction.
- `list_budgets`: Check your budget status.
- `list_categories`: View all transaction categories.
- `list_wallets`: View all configured wallets.