# kubera-mcp

MCP server for [Kubera](https://kubera.com) — lets LLMs (Claude, Gemini, etc.) read and update your portfolio data.

## Tools

| Tool | Description |
|------|-------------|
| `kubera_list_portfolios` | List all portfolios |
| `kubera_get_portfolio_data` | Fetch assets, debts, and net worth for a portfolio |
| `kubera_update_item` | Update the value of a manual asset or debt |

## Requirements

- Docker (recommended) or Node.js 18+
- Kubera API Key & Secret — get from **Kubera → Settings → API**

## Setup

### Docker (recommended)

```bash
docker build -t kubera-mcp .
```

### Local Node

```bash
npm install && npm run build
```

## Configuration

Copy `.env.example` to `.env` and fill in your credentials:

```bash
KUBERA_API_KEY=your_api_key
KUBERA_API_SECRET=your_api_secret
```

## MCP Client Config

### Docker

```json
{
  "mcpServers": {
    "kubera": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "KUBERA_API_KEY", "-e", "KUBERA_API_SECRET", "kubera-mcp"],
      "env": {
        "KUBERA_API_KEY": "your_api_key",
        "KUBERA_API_SECRET": "your_api_secret"
      }
    }
  }
}
```

### Local Node

```json
{
  "mcpServers": {
    "kubera": {
      "command": "node",
      "args": ["/absolute/path/to/kubera-mcp/dist/index.js"],
      "env": {
        "KUBERA_API_KEY": "your_api_key",
        "KUBERA_API_SECRET": "your_api_secret"
      }
    }
  }
}
```