Hecher MCP Server

The official Model Context Protocol (MCP) server for Hecher — the multi-tenant CRM for Chabad shluchim by Grow Gelt.

Connect Claude Desktop, ChatGPT, Cursor, or any other MCP‑compatible AI assistant to your Hecher account and let it search donors, record donations, run reports, and manage tasks for you — across all of your organizations (mosads).

Heads up: This repository is the public listing and documentation for the Hecher MCP server. The server itself runs as a managed remote service at https://api.hecher.app/mcp — there is nothing to install or self-host.

Quick start

In your MCP‑compatible client (Claude Desktop, ChatGPT, Cursor, etc.), add a new remote MCP server with this URL:
```
https://api.hecher.app/mcp
```
The first time you use it, your browser will open and ask you to sign in to Hecher and approve the connection.
Once approved, the assistant can act on your account.

You can review and revoke connected assistants anytime under Settings → AI Connections inside Hecher.

What it can do

The server exposes 20 tools that wrap the Hecher API. Every call runs as you, in whichever Mosad you've selected as active — RLS, billing gates, and audit logging all apply exactly as in the web app.

Organizations (Mosads)

list_tenants — list the Mosads you have access to
set_active_tenant — choose which Mosad subsequent calls operate on
get_active_tenant — show the currently active Mosad

Donors

search_donors — search by name, email, phone, tag, or status
get_donor — full profile with stats and contact info
create_donor / update_donor / delete_donor
add_donor_tag / remove_donor_tag / bulk_tag_donors

Donations

list_donations — optionally filtered by donor or date
create_donation / update_donation / delete_donation

Activities & tasks

list_activities — optionally filtered by donor, status, or assignee
create_activity — task, call, meeting, or note
complete_activity

Reporting

get_dashboard_stats — KPIs for the active Mosad
run_report — execute a saved report

Authentication

The server speaks OAuth 2.1 with dynamic client registration, so any compliant MCP client can connect with no manual API keys.

Endpoint	URL
Discovery	`https://api.hecher.app/.well-known/oauth-authorization-server`
Authorization	`https://api.hecher.app/oauth/authorize`
Token	`https://api.hecher.app/oauth/token`
Dynamic registration	`https://api.hecher.app/oauth/register`

Each authorization issues an access token bound to your user account and the Mosad you pick during the consent flow. Tokens can be revoked at any time from Settings → AI Connections.

Permissions & limits

Tools act with the permissions of the signed‑in user in the active Mosad — no privilege escalation.
All write operations honor Hecher's billing gates and audit log.
Per‑user rate limits from the Hecher API gateway apply.
Bulk mutations (e.g. bulk_tag_donors) flow through Hecher's background operation queue, the same as in the web UI.

Compatible clients

Any MCP client that supports remote servers over Streamable HTTP with OAuth 2.1, including:

Claude Desktop
ChatGPT
Cursor
Cline
Continue
Any custom client built on the MCP SDKs

Support

Product: hecher.app
Issues with this listing or the MCP server: open an issue in this repository
General Hecher support: through the in‑app feedback button

Hecher CRM