# Angaria

> Angaria is an MCP server for finance and payments. Create, sign and download Turkish e-Arsiv invoices through the Angaria Mac app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS
- **Website:** https://angaria.app/en
- **Repository:** https://github.com/vinenastudio/angaria-mcp
- **MCP Registry name:** app.angaria/angaria
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Angaria is a Mac app for GIB's e-Arsiv Portal, and its MCP server lets Claude, Codex, Cursor and others work with it. The assistant creates a draft in the portal under the user's own account, and signing needs the SMS code GIB sends. Signing and deletion stay off until the user turns on a switch named for letting agents sign, and the README says those tools return an error naming it while it is off.

The server runs inside the app, so it works only while Angaria is open. Claude Desktop connects through a small local helper, while other clients use a local HTTP address. Angaria connects only to the e-Arsiv portal, the central bank for exchange rates, a licence check, updates and optional feedback, and the GIB password stays in the macOS Keychain. The app and tool answers are in Turkish, and it needs macOS 11 or later.

## Features

- **Draft invoices:** create_invoice builds an unsigned draft.
- **Invoice lookup:** list_invoices and get_invoice read existing invoices.
- **Duplicate:** duplicate_invoice copies one into a new dated draft.
- **PDF and ZIP download:** download_invoice saves the PDF or GIB's ZIP.
- **Signing gate:** Signing needs a switch and the SMS code.

## Good for

- Ask an assistant to issue last month's recurring invoice
- Look up invoices in a date range
- Download invoice PDFs in Turkish and English

## Install

### Claude Code (Terminal)

```sh
claude mcp add angaria -- npx -y https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "angaria": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "angaria": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "angaria": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "angaria": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "angaria": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb"
      ]
    }
  }
}
```

## Tools

- `list_invoices`: Lists invoices between two dates, at most 31 days.
- `get_invoice`: Gets an invoice's recipient, lines and totals.
- `create_invoice`: Creates an unsigned draft invoice.
- `duplicate_invoice`: Creates a new draft from an existing invoice.
- `download_invoice`: Saves the PDF or GIB ZIP to Downloads.

## FAQ

### Does the app need to be open?

Yes, the MCP server works only while Angaria is running.

### Does it cost anything?

Angaria is paid, with a 7-day free trial; card details are required for the trial.

### Which assistants cannot connect?

ChatGPT, browser and phone assistants.

### Where does my GIB password go?

It stays in the macOS Keychain.

### Is Angaria free?

Angaria is a paid product with a free trial.

### How do I add Angaria to Claude Code?

Run this command in your terminal: claude mcp add angaria -- npx -y https://github.com/vinenastudio/angaria-mcp/releases/download/v0.1.0/angaria-mcp.mcpb

### What are the best alternatives to Angaria?

The closest alternatives to Angaria are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/angaria
