# Enterich

> Enterich is an open-source MCP server for finance and payments. ERPNext accounting for AI agents: 37 fixed tools that read data and only create drafts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API
- **Repository:** https://github.com/interlusion/enterich
- **MCP Registry name:** dev.interlusion/enterich
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

Enterich is built around limits. It is a separate service, not a Frappe app, that calls ERPNext's REST API with the API key of one dedicated agent user, so whatever that user's ERPNext role forbids, the agent cannot do. Callers authenticate with OAuth tokens from an external authorization server such as Keycloak, and Enterich checks issuer, audience, client and subject on every token itself.

The 37 tools are grouped by accounting area: master data, order to cash, procure to pay, record to report, and bank and cash. Reads cover items, customers, suppliers, invoices, accounts, the general ledger, trial balance, receivables and payables. Writes are limited to creating and updating drafts of invoices, returns, journal entries and payment entries. No tool submits, cancels, amends or deletes, so a person reviews and posts each draft in ERPNext.

It is deliberately not a general API bridge: tools taking a DocType, method name, filter expression or file path are out of scope. Settings let an operator restrict the tool list and cap drafts per hour, and each deployment serves one company. It ships as an OCI image under Apache-2.0, maintained for the authors' own use with no promised support, and is not affiliated with Frappe.

## Features

- **Fixed tool list:** 37 purpose-built tools with their own schemas, no generic document access.
- **Drafts only:** Agents create and update drafts; people submit them in ERPNext.
- **One agent user:** ERPNext's role for a single dedicated user is the upper limit.
- **OAuth resource server:** Validates issuer, audience, client and subject on each token.
- **Single company scope:** Every tool works on one assigned company.
- **Operator controls:** Restrict which tools are offered and limit drafts per hour.

## Good for

- Have an agent draft sales invoices for review
- Pull a trial balance or general ledger into a chat
- Check accounts receivable and payable
- Prepare draft journal entries for an accountant to post

## Install

### Claude Code (Terminal)

```sh
claude mcp add enterich --env ENTERICH_RESOURCE_URL='<ENTERICH_RESOURCE_URL>' --env ENTERICH_ISSUER='<ENTERICH_ISSUER>' --env ENTERICH_JWKS_URL='<ENTERICH_JWKS_URL>' --env ENTERICH_CLIENT_ID='<ENTERICH_CLIENT_ID>' --env ENTERICH_SUBJECT='<ENTERICH_SUBJECT>' --env ENTERICH_ERPNEXT_URL='<ENTERICH_ERPNEXT_URL>' --env ENTERICH_ERPNEXT_PUBLIC_URL='<ENTERICH_ERPNEXT_PUBLIC_URL>' --env ENTERICH_ERPNEXT_API_KEY='<ENTERICH_ERPNEXT_API_KEY>' --env ENTERICH_ERPNEXT_API_SECRET='<ENTERICH_ERPNEXT_API_SECRET>' --env ENTERICH_COMPANY='<ENTERICH_COMPANY>' -- docker run -i --rm -e ENTERICH_RESOURCE_URL -e ENTERICH_ISSUER -e ENTERICH_JWKS_URL -e ENTERICH_CLIENT_ID -e ENTERICH_SUBJECT -e ENTERICH_ERPNEXT_URL -e ENTERICH_ERPNEXT_PUBLIC_URL -e ENTERICH_ERPNEXT_API_KEY -e ENTERICH_ERPNEXT_API_SECRET -e ENTERICH_COMPANY ghcr.io/interlusion/enterich:0.6.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "enterich": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ENTERICH_RESOURCE_URL",
        "-e",
        "ENTERICH_ISSUER",
        "-e",
        "ENTERICH_JWKS_URL",
        "-e",
        "ENTERICH_CLIENT_ID",
        "-e",
        "ENTERICH_SUBJECT",
        "-e",
        "ENTERICH_ERPNEXT_URL",
        "-e",
        "ENTERICH_ERPNEXT_PUBLIC_URL",
        "-e",
        "ENTERICH_ERPNEXT_API_KEY",
        "-e",
        "ENTERICH_ERPNEXT_API_SECRET",
        "-e",
        "ENTERICH_COMPANY",
        "ghcr.io/interlusion/enterich:0.6.0"
      ],
      "env": {
        "ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
        "ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
        "ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
        "ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
        "ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
        "ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
        "ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
        "ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
        "ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
        "ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "enterich": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ENTERICH_RESOURCE_URL",
        "-e",
        "ENTERICH_ISSUER",
        "-e",
        "ENTERICH_JWKS_URL",
        "-e",
        "ENTERICH_CLIENT_ID",
        "-e",
        "ENTERICH_SUBJECT",
        "-e",
        "ENTERICH_ERPNEXT_URL",
        "-e",
        "ENTERICH_ERPNEXT_PUBLIC_URL",
        "-e",
        "ENTERICH_ERPNEXT_API_KEY",
        "-e",
        "ENTERICH_ERPNEXT_API_SECRET",
        "-e",
        "ENTERICH_COMPANY",
        "ghcr.io/interlusion/enterich:0.6.0"
      ],
      "env": {
        "ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
        "ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
        "ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
        "ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
        "ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
        "ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
        "ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
        "ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
        "ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
        "ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "enterich": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ENTERICH_RESOURCE_URL",
        "-e",
        "ENTERICH_ISSUER",
        "-e",
        "ENTERICH_JWKS_URL",
        "-e",
        "ENTERICH_CLIENT_ID",
        "-e",
        "ENTERICH_SUBJECT",
        "-e",
        "ENTERICH_ERPNEXT_URL",
        "-e",
        "ENTERICH_ERPNEXT_PUBLIC_URL",
        "-e",
        "ENTERICH_ERPNEXT_API_KEY",
        "-e",
        "ENTERICH_ERPNEXT_API_SECRET",
        "-e",
        "ENTERICH_COMPANY",
        "ghcr.io/interlusion/enterich:0.6.0"
      ],
      "env": {
        "ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
        "ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
        "ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
        "ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
        "ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
        "ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
        "ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
        "ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
        "ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
        "ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "enterich": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ENTERICH_RESOURCE_URL",
        "-e",
        "ENTERICH_ISSUER",
        "-e",
        "ENTERICH_JWKS_URL",
        "-e",
        "ENTERICH_CLIENT_ID",
        "-e",
        "ENTERICH_SUBJECT",
        "-e",
        "ENTERICH_ERPNEXT_URL",
        "-e",
        "ENTERICH_ERPNEXT_PUBLIC_URL",
        "-e",
        "ENTERICH_ERPNEXT_API_KEY",
        "-e",
        "ENTERICH_ERPNEXT_API_SECRET",
        "-e",
        "ENTERICH_COMPANY",
        "ghcr.io/interlusion/enterich:0.6.0"
      ],
      "env": {
        "ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
        "ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
        "ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
        "ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
        "ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
        "ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
        "ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
        "ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
        "ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
        "ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "enterich": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ENTERICH_RESOURCE_URL",
        "-e",
        "ENTERICH_ISSUER",
        "-e",
        "ENTERICH_JWKS_URL",
        "-e",
        "ENTERICH_CLIENT_ID",
        "-e",
        "ENTERICH_SUBJECT",
        "-e",
        "ENTERICH_ERPNEXT_URL",
        "-e",
        "ENTERICH_ERPNEXT_PUBLIC_URL",
        "-e",
        "ENTERICH_ERPNEXT_API_KEY",
        "-e",
        "ENTERICH_ERPNEXT_API_SECRET",
        "-e",
        "ENTERICH_COMPANY",
        "ghcr.io/interlusion/enterich:0.6.0"
      ],
      "env": {
        "ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
        "ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
        "ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
        "ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
        "ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
        "ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
        "ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
        "ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
        "ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
        "ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
      }
    }
  }
}
```

## Tools

- `list_items`: List items
- `get_item`: Get item
- `list_customers`: List customers
- `get_customer`: Get customer
- `list_sales_invoices`: List sales invoices
- `get_sales_invoice`: Get sales invoice
- `report_accounts_receivable`: Accounts receivable report
- `create_draft_sales_invoice`: Create a draft sales invoice
- `list_suppliers`: List suppliers
- `list_purchase_invoices`: List purchase invoices
- `report_accounts_payable`: Accounts payable report
- `create_draft_purchase_invoice`: Create a draft purchase invoice
- `report_general_ledger`: General ledger report
- `report_trial_balance`: Trial balance report
- `create_draft_journal_entry`: Create a draft journal entry
- `list_bank_transactions`: List bank transactions
- `list_payment_entries`: List payment entries
- `create_draft_payment_entry`: Create a draft payment entry

## FAQ

### Can the agent post or delete documents?

No. No tool submits, cancels, amends, deletes or discards a document.

### How is it deployed?

As an OCI container image, ghcr.io/interlusion/enterich, configured with environment variables.

### Which ERPNext version is tested?

The README says operations are tested against a model of v16's API and weekly against a real v16 site.

### What licence is it under?

Apache-2.0.

### Is Enterich free?

Yes. Enterich is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add enterich --env ENTERICH_RESOURCE_URL='<ENTERICH_RESOURCE_URL>' --env ENTERICH_ISSUER='<ENTERICH_ISSUER>' --env ENTERICH_JWKS_URL='<ENTERICH_JWKS_URL>' --env ENTERICH_CLIENT_ID='<ENTERICH_CLIENT_ID>' --env ENTERICH_SUBJECT='<ENTERICH_SUBJECT>' --env ENTERICH_ERPNEXT_URL='<ENTERICH_ERPNEXT_URL>' --env ENTERICH_ERPNEXT_PUBLIC_URL='<ENTERICH_ERPNEXT_PUBLIC_URL>' --env ENTERICH_ERPNEXT_API_KEY='<ENTERICH_ERPNEXT_API_KEY>' --env ENTERICH_ERPNEXT_API_SECRET='<ENTERICH_ERPNEXT_API_SECRET>' --env ENTERICH_COMPANY='<ENTERICH_COMPANY>' -- docker run -i --rm -e ENTERICH_RESOURCE_URL -e ENTERICH_ISSUER -e ENTERICH_JWKS_URL -e ENTERICH_CLIENT_ID -e ENTERICH_SUBJECT -e ENTERICH_ERPNEXT_URL -e ENTERICH_ERPNEXT_PUBLIC_URL -e ENTERICH_ERPNEXT_API_KEY -e ENTERICH_ERPNEXT_API_SECRET -e ENTERICH_COMPANY ghcr.io/interlusion/enterich:0.6.0

### What are the best alternatives to Enterich?

The closest alternatives to Enterich are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

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