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_broadcast
Read one broadcast by the id the send answered with, with its tallies, the sentence the creator reads, the failures by reason and the first fifty members it could not reach.