find_member_by_identity
Find the project member who connected a given account on a connector, from the connector key and the platform's own id.
Turns the id a bot or a server hands over into a Subscriby member: give it the project, the connector the account lives on and the platform's own id for the account, and it answers the same row get_subscriber does, with the member's connected accounts embedded as identities[]. This is the lookup for a workflow that starts from a platform event (a message, a join, a role change) and needs to know which member, if any, that account belongs to. An account nobody in the project has connected is RESOURCE_NOT_FOUND, indistinguishable from an unknown project, so a caller never learns whether an id exists elsewhere. The REST twin is the identity filter on GET /v1/projects/{project}/members, which returns a one-row page instead.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project the member belongs to.
connector*stringConnector key the account lives on, as `list_connectors` lists them.
external_id*stringThe platform's own id for the account, as `list_member_identities` shows it.
What it returns
{ "data": { "id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "status": "customer", "name": "Ada Lovelace", "identities": [ { "id": "6a1f0c3e-2d4b-4e8a-9c7d-1b5e3f9a2c4d", "connector": "telegram", "source": "handshake", "preferred": true, "external_id": "123456789", "display_name": "Ada Lovelace", "username": "ada", "linked_at": "2026-09-12T10:05:00Z" } ], "created_at": "2026-05-18T10:40:00Z" }}The row is the one get_subscriber and list_subscribers render; identities[] lists every account the member connected, not only the one asked about.
How it fails
RESOURCE_NOT_FOUNDunknown project_id, a project outside the token's scope, or an account nobody in the project has connected.
TOKEN_MISSING_ABILITYtoken lacks project-user:view-any.
How is this guide?
Last updated on
broadcast_message
Send a message through the project's connector to a segment of its members. Destructive and irreversible — preview the audience and get human approval first.
get_subscriber
One project member by UUID, in the list_subscribers row shape. Returns two email addresses verbatim — scrub before forwarding.