# `get_goal_match`

Reads one currently listed saved match and its authorized assessment.

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

## Inputs

| Input | Required | Description |
| --- | --- | --- |
| `matchId` | yes | Exact match UUID from a match collection or authorized conversation |

## Returns

The match resource directly: the same `id`, `name`, `route`, `context`, `fit`, `introduction`, and `ownOutreach` as a match summary, plus:

| Field | Description |
| --- | --- |
| `goalId` | Parent goal identity |
| `goalOwnerName` | Authorized display name of the member who owns the goal, or null |
| `viewerRole` | `goal_owner` or `connector` |
| `beneficiary` | `{ personId, name }` for an owned goal for someone else, otherwise null |
| `assessedGoalText` | Wording this assessment used; an `earlier` assessment is not reassessed for edited wording |
| `publicIdentity` | Nullable `headline`, `currentRole`, and `linkedInUrl` from the safe LinkedIn projection; own-contact profiles use the separate person read |
| `assessment` | Nullable object with `summary`, `howTheyCouldHelp`, `whatTheBeneficiaryCouldOffer`, `valueToBeneficiary`, and `valueToCandidate` |
| `memberSuppliedReason` | The member's reason for suggesting this person, or null; it is not a model assessment |
| `offeredToBeneficiary` | Whether the goal owner already offered this own contact to the beneficiary |

Strengths are `borderline_yes`, `clear_yes`, `strong_yes`, or null. They refer to the named beneficiary, otherwise the goal owner. A hand-added match has its member's reason and a null assessment. A personal offer originating from a search can retain coarse strengths without private assessment prose.

For `route.kind: "own_contact"`, use its `personId` with [`get_person`](/docs/mcp/tools/get_person) for your own contact's profile and relationship context. Through-member requester views contain only the safe name, selected public LinkedIn fields, requester-safe explanation, and coarse strengths. They never carry the other owner's person ID, contact details, relationship context, or private evidence. Connector reads concern their own contacts; MCP adds no connector collection discovery.

Missing, inaccessible, unlisted, and ended-goal matches return `unavailable`. This Get does not read archived match history. Nothing is refreshed, chosen, approved, or sent. A match establishes neither willingness nor a successful introduction. Open the returned goal link to discuss or act in Gravity.

## Example

```json get_goal_match
{
  "matchId": "00000000-0000-4000-a000-000000000002"
}
```

Result (synthetic data):

```json result:get_goal_match
{
  "id": "00000000-0000-4000-a000-000000000002",
  "name": "Synthetic candidate",
  "route": { "kind": "through_member", "connector": { "memberId": "00000000-0000-4000-a000-000000000003", "name": "Synthetic connector" } },
  "context": "current",
  "fit": "potential_win_win",
  "introduction": "not_requested",
  "ownOutreach": null,
  "goalId": "00000000-0000-4000-a000-000000000001",
  "goalOwnerName": "Synthetic requester",
  "viewerRole": "goal_owner",
  "beneficiary": null,
  "assessedGoalText": "Find design partners",
  "publicIdentity": { "headline": "Public headline", "currentRole": "Public role", "linkedInUrl": null },
  "assessment": { "summary": "Possible design partner", "howTheyCouldHelp": "Could discuss the product", "whatTheBeneficiaryCouldOffer": "Product feedback", "valueToBeneficiary": "clear_yes", "valueToCandidate": "borderline_yes" },
  "memberSuppliedReason": null,
  "offeredToBeneficiary": false
}
```
