# Find matches and search again

Read a goal and its matches, then search networks that haven't been searched yet.

The request in this guide: "Any new matches for my investor goal in Founders dinner? If Priya's network hasn't been searched, search it."

## 1. Find the group

Call [`list_groups`](/docs/mcp/tools/list_groups) and find Founders dinner's `publicId`. If more than one group could be meant, ask which one.

```json list_groups
{}
```

## 2. Find the goal

Call [`get_group_details`](/docs/mcp/tools/get_group_details) with that `publicId`. In `ownGoals`, find the goal about investors. If more than one could fit, ask which one.

```json get_group_details
{ "groupPublicId": "3a9f0c6e1b2d4e5f8a7b6c5d4e3f2a1b" }
```

## 3. Read the goal

Call [`get_goal`](/docs/mcp/tools/get_goal) with the goal's `id`. Note `goal.scopeVersion` and `goal.contextRevisionId` for later, and check `matching.run` and `searchQueued`.

```json get_goal
{ "goalId": "6f1c2a3e-4b5d-4e6f-8a7b-9c0d1e2f3a4b" }
```

## 4. Read the saved matches

Call [`get_goal_matches`](/docs/mcp/tools/get_goal_matches) and summarize what Gravity found. This starts nothing and contacts nobody.

```json get_goal_matches
{ "goalId": "6f1c2a3e-4b5d-4e6f-8a7b-9c0d1e2f3a4b" }
```

## 5. Decide whether to search

Look at `matching.run` from step 3:

- If it's `running`, or `searchQueued` is true, a search is already on its way. Say so and skip to step 7.
- If Priya appears in `eligibleMembers`, her network hasn't been searched for this version of the goal. You were asked to search it, so continue.
- Otherwise, there's nothing new to search. Say so and stop.

## 6. Start the search

Call [`start_goal_matching`](/docs/mcp/tools/start_goal_matching) with `mode: "new-members"`, the versions from step 3, and a new `requestId`.

```json start_goal_matching
{
  "goalId": "6f1c2a3e-4b5d-4e6f-8a7b-9c0d1e2f3a4b",
  "goalScopeVersion": 3,
  "goalContextRevisionId": "c2d3e4f5-a6b7-4c8d-b9e0-f1a2b3c4d5e6",
  "mode": "new-members",
  "requestId": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a"
}
```

If the call fails before you get a result, retry once with the same `requestId` and identical arguments. Gravity won't start a second search.

## 7. Follow it to the end

Call [`get_goal`](/docs/mcp/tools/get_goal) every 30 to 60 seconds until `matching.run.status` is `complete` or `failed`. Then read [`get_goal_matches`](/docs/mcp/tools/get_goal_matches) again and report what's new.

If any step returns "This goal changed or is unavailable", go back to step 3.