Connectivity sanity check — returns CiviCRM version (via Domain entity), the authenticated bot contact, and a count of installed extensions. Run first when debugging auth or URL setup.

Resolves the authenticated bot contact and probes which CiviCRM entities it can read. Use this first when setting up the server — it surfaces the most common misconfigurations (wrong API key, missing 'authenticate with api key' permission, bot contact lacks 'access CiviCRM'). Does not probe writes.

Search CiviCRM contacts by name or primary email. Returns id, display name, type, primary email and phone.

Fetch a single CiviCRM contact by id. Returns core profile plus primary email/phone/address; pass fields to override.

List relationships (family, employer, membership, custom types) for a contact. Resolves the other party's display name and direction automatically.

List contributions (donations, dues, event fees) with optional filters by contact, date window, status, and financial type. Resolves donor display name and human-readable status labels.

List CiviEvent events. Defaults to upcoming only. Returns id, title, type, dates, public/online flags.

List SavedSearch records (the SearchKit queries an admin has built in the UI). Use this to discover what's available to run via civicrm_run_saved_search.

Execute a SavedSearch and return its rows via SearchDisplay.run. Pair with civicrm_list_saved_searches to discover available searches. This is the safest and cheapest way to run complex queries — the admin curates the query in the UI, the agent just calls it by name.

List all CiviCRM APIv4 entities available on this install (including those added by extensions). Optional substring filter.

Introspect an APIv4 entity — returns available fields (incl. custom fields) and actions. Call this before civicrm_api4 when unsure of field names or action support.

Return the option list (pseudoconstant values) for a single field on an entity. Far cheaper than civicrm_describe_entity when you only need to know the valid values for one enum-like field — e.g. 'what are the legal activity_type values'.

Create a new CiviCRM contact. Chains email and phone creation when provided. Requires CIVICRM_ALLOW_WRITES=true.

Update fields on a single CiviCRM contact by id. Requires CIVICRM_ALLOW_WRITES=true.

Record an Activity against a target contact. Requires CIVICRM_ALLOW_WRITES=true.

Record a donation / contribution for a contact. Requires CIVICRM_ALLOW_WRITES=true.

Add a contact to a group (GroupContact status='Added'). Idempotent — updates an existing row rather than creating duplicates. Requires CIVICRM_ALLOW_WRITES=true.

Mark a contact as Removed from a group (GroupContact status='Removed'). Preserves history — does not hard-delete. Requires CIVICRM_ALLOW_WRITES=true.

Create a Participant record registering a contact for an event. Requires CIVICRM_ALLOW_WRITES=true.

Create a Membership record for a contact. CiviCRM will auto-calculate start/end dates from the membership type's duration if omitted. Requires CIVICRM_ALLOW_WRITES=true.

Attach a free-text Note to a contact, contribution, activity, case, or relationship. Requires CIVICRM_ALLOW_WRITES=true. Notes are the right place for unstructured context that doesn't belong in a custom field.

Add a tag to one or more contacts in a single call. Idempotent — re-tagging an already-tagged contact is a no-op. Requires CIVICRM_ALLOW_WRITES=true.

Remove a tag from one or more contacts in a single call. Requires CIVICRM_ALLOW_WRITES=true AND CIVICRM_ALLOW_DELETES=true (EntityTag rows are hard-deleted).

Send (or re-send) the standard receipt email for a contribution. Wraps Contribution.sendconfirmation. Requires CIVICRM_ALLOW_WRITES=true because the call triggers an outbound email.

Generic APIv4 call. Accepts entity + action + params. Disabled unless CIVICRM_ALLOW_GENERIC_API=true; writes additionally need CIVICRM_ALLOW_WRITES and deletes need CIVICRM_ALLOW_DELETES. Use civicrm_describe_entity first if unsure of field names.