MCP Tools

The tools the Esperto MCP connector exposes inside Claude, and the API end-point each one calls.

Members

Tool	Endpoint	What it does
esperto_list_members	GET /members	List members (supports limit / offset).
esperto_get_member	GET /members/{id}	Get a single member by id.
esperto_create_member	POST /members	Create a new member.
esperto_members_dupecheck	POST /members/dupecheck	Check whether a member email already exists.
esperto_update_member	PATCH /members/{id}	Update an existing member.
esperto_list_member_reports	GET /members/{id}/reports	Get all reports for a member.

Groups

Tool	Endpoint	What it does
esperto_list_groups	GET /groups	List all groups (folders in the Members tree).
esperto_create_group	POST /groups	Create a new group.
esperto_groups_dupecheck	POST /groups/dupecheck	Check whether a group name/alias already exists.
esperto_get_group	GET /groups/{id}	Get a single group by id.
esperto_get_group_members	GET /groups/{id}/members	Get all members in a group.
esperto_list_groupless_members	GET /groups/nogroup/members	List members not assigned to any group.
esperto_add_member_to_group	POST /groups/{id}/members/{memberId}	Add an existing member to a group.

Campaigns

Manage invitations, mails and reminders to get people to participate.

Tool	Endpoint	What it does
esperto_list_campaigns	GET /campaigns	List all campaigns.
esperto_get_campaign	GET /campaigns/{id}	Get a single campaign by id.
esperto_create_campaign	POST /campaigns	Create a new campaign.
esperto_campaigns_dupecheck	POST /campaigns/dupecheck	Check whether a campaign name already exists.
esperto_update_campaign	PATCH /campaigns/{id}	Update a campaign.
esperto_delete_campaign	DELETE /campaigns/{id}	Delete a campaign.
esperto_get_campaign_reports	GET /campaigns/{id}/reports	Reports for a campaign.
esperto_get_campaign_members	GET /campaigns/{id}/members	Members in a campaign.
esperto_add_campaign_members	POST /campaigns/{id}/members	Add member(s) in bulk.
esperto_add_campaign_member	POST /campaigns/{id}/members/{memberId}	Add a single member.
esperto_get_campaign_member	GET /campaigns/{id}/members/{memberId}	Get a member's participation record.
esperto_update_campaign_member	PATCH /campaigns/{id}/members/{memberId}	Update a campaign member.
esperto_remove_campaign_member	DELETE /campaigns/{id}/members/{memberId}	Remove one member.
esperto_remove_all_campaign_members	DELETE /campaigns/{id}/members/all	Remove all members.
esperto_reset_campaign_member	PATCH /campaigns/{id}/members/{memberId}/reset	Reset a member's progress.
esperto_get_campaign_member_reports	GET /campaigns/{id}/members/{memberId}/reports	Reports for one campaign member.
esperto_invite_campaign_members	POST /campaigns/{id}/members/invite	⚠️ Sends real invitation emails.
esperto_remind_campaign_members	POST /campaigns/{id}/members/remind	⚠️ Sends real reminder emails.

⚠️ invite and remind dispatch real email. Only run them against a campaign whose members are addresses you control. See the Campaigns guide.

Two things to know

Tool arguments are camelCase. ⚠️ The tools take camelCase identifiers — groupId, memberId — even though the API's own JSON data fields are lowercase (groupid, memberid). Passing groupid/memberid to a tool fails with an input-validation error. Use camelCase for tool arguments; expect lowercase in the returned data.

Dupecheck before you create. The API rejects duplicate member emails and duplicate group names/aliases. Run esperto_members_dupecheck or esperto_groups_dupecheck first so you know up front whether a create will succeed. See FAQ & Troubleshooting.

Want more tools?

The connector covers the scopes currently opened (/members, /groups, /campaigns). As more scopes are enabled — Reports, Settings — matching tools are added. Contact us if you need an endpoint that isn't exposed yet.