# `list_introductions`

Lists introductions under way between you and other members, those waiting on you first.

Annotations: `readOnlyHint: true` · `destructiveHint: false` · `idempotentHint: true` · `openWorldHint: false`

## When to use it

For "what needs me in Gravity?", "is anyone waiting on me?", or a regular check-in on the member's introductions. It covers both sides: requests a member asked you to make, offers a member made you, and the ones you're waiting on. Introductions on ended goals, and declined ones, aren't listed.

Answering happens in Gravity. For each one with `needsYou`, say who wants an introduction to whom and for which goal, and give its `link`. Don't claim anyone is willing, and don't contact anyone.

## Inputs

No inputs.

## Returns

`{ "introductions": [...] }`, those waiting on you first, then newest first. Each introduction has:

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Introduction ID |
| `role` | string | `connector` when you were asked to introduce someone you know, `requester` when you asked or were offered |
| `state` | string | `intro_waiting` (asked, waiting on the connector), `intro_offered` (offered, waiting on the requester), or `intro_ask_sent` (the connector sent their note to the person) |
| `needsYou` | boolean | Waiting on your answer |
| `contactName` | string | The person the introduction is to |
| `requesterName`, `connectorName` | string | The two members |
| `goal` | object | `{ id, text }`, the goal the introduction is for |
| `group` | object | `{ name }`, where the conversation is |
| `requestedAt` | string | ISO 8601 timestamp of the request or offer |
| `decidedAt` | string or null | When the connector sent their note, if they have |
| `link` | string, optional | Opens this introduction's card in Gravity |

## Example

```json list_introductions
{}
```

Result (synthetic data):

```json result:list_introductions
{
  "introductions": [
    {
      "id": "00000000-0000-4000-a000-000000000002",
      "role": "connector",
      "state": "intro_waiting",
      "needsYou": true,
      "contactName": "Synthetic candidate",
      "requesterName": "Synthetic member",
      "connectorName": "Synthetic connector",
      "goal": { "id": "00000000-0000-4000-a000-000000000001", "text": "Find design partners" },
      "group": { "name": "Synthetic founders" },
      "requestedAt": "2026-10-09T00:00:00.000Z",
      "decidedAt": null,
      "link": "https://www.meetgravity.ai/dashboard/agent?request=00000000-0000-4000-a000-000000000002"
    }
  ]
}
```

## Related

- [`list_goal_matches`](/docs/mcp/tools/list_goal_matches) reads the matches for one of your goals, including whether an introduction was requested or offered.
- [`list_goals`](/docs/mcp/tools/list_goals) lists your active goals.
