Teaming match MCP response

MCP tool response returned when agents retrieve or change GovTribe teaming match records through MCP tools.

Returned by: Search teaming matches MCP tool; Request teaming match MCP tool; Create interest and request match MCP tool; Respond to teaming match MCP tool; Withdraw teaming match MCP tool; Submit teaming match feedback MCP tool
Response type: Structured teaming match record

Response Shape

The returned teaming match record represents a connection between one prime teaming interest and one sub teaming interest on the same opportunity. Matches are visible only to the two participants.

Field	Type	Notes
`govtribe_id`	string	GovTribe ID for the teaming match. Pass this value into `teaming_match_id` for respond, withdraw, or feedback calls.
`govtribe_type`	string	Always `teaming_match`.
`govtribe_url`	string	GovTribe URL for the teaming match page.
`name`	string	Match display name.
`status`	string	Lifecycle status: `pending`, `accepted`, `declined`, `withdrawn`, or `expired`. Declined, withdrawn, and expired matches stop appearing in agent retrieval.
`rationale`	string or null	Short explanation of why the match was requested or suggested.
`requester_user_model_id`	string	GovTribe ID of the user who sent the match request. Compare with the viewer to decide between responding and withdrawing.
`withdrawn_by_user_model_id`	string or null	GovTribe ID of the user who withdrew the match, when withdrawn.
`expires_at`	string or null	When a pending match request expires.
`created_at`	string	Match creation timestamp.
`updated_at`	string	Match update timestamp.
`prime_accepted_at`	string or null	When the prime side accepted.
`sub_accepted_at`	string or null	When the sub side accepted.
`first_recipient_message_at`	string or null	When the recipient first replied in the match conversation.
`response_time`	number or null	Seconds between the match request and the recipient's response.
`prime_teaming_interest`	object	Nested teaming interest record for the prime side.
`sub_teaming_interest`	object	Nested teaming interest record for the sub side.
`viewer_context`	object or null	Viewer-specific snapshot. Includes `role` (`prime` or `sub`), `action_required` (`accept_decline`, `await_response`, or null), `vendor_identities_revealed`, `other_party_display_name`, and `other_party_avatar_source`.
`feedback_for_me`	object or null	Feedback the viewer's account submitted on this match, when present.
`feedback_from_other_party`	object or null	Feedback the other participant's account submitted, when present.
`conversation_summary`	object or null	Snapshot of the match conversation, when one exists.

Follow-up Behavior

Search_Teaming_Matches returns only govtribe_id when you omit fields_to_return. Mutation tools return the full record for the affected match.

Use viewer_context.action_required to route the next step: accept_decline means the viewer should respond with the Respond to teaming match MCP tool, and await_response means the viewer is the requester and can only wait or withdraw.

Declined, withdrawn, and expired matches are removed from agent retrieval, so respond, withdraw, and feedback calls against them return a not-found error.

Example

{
  "govtribe_id": "TEAMING_MATCH_ID",
  "govtribe_type": "teaming_match",
  "govtribe_url": "https://govtribe.com/teaming-match/TEAMING_MATCH_ID",
  "name": "Teaming Match",
  "status": "pending",
  "rationale": "Match requested by a FedRAMP-authorized cloud migration small business.",
  "requester_user_model_id": "REQUESTER_USER_ID",
  "withdrawn_by_user_model_id": null,
  "expires_at": "2026-05-04T17:34:23Z",
  "created_at": "2026-03-04T23:30:10Z",
  "updated_at": "2026-05-13T18:55:35Z",
  "prime_accepted_at": null,
  "sub_accepted_at": null,
  "first_recipient_message_at": null,
  "response_time": null,
  "prime_teaming_interest": {
    "govtribe_id": "PRIME_INTEREST_ID",
    "govtribe_type": "teaming_interest",
    "govtribe_url": "https://govtribe.com/teaming/PRIME_INTEREST_ID",
    "name": "Request for proposal - Commercial online platform acquisition"
  },
  "sub_teaming_interest": {
    "govtribe_id": "SUB_INTEREST_ID",
    "govtribe_type": "teaming_interest",
    "govtribe_url": "https://govtribe.com/teaming/SUB_INTEREST_ID",
    "name": "Request for proposal - Commercial online platform acquisition"
  },
  "viewer_context": {
    "role": "prime",
    "action_required": "accept_decline",
    "vendor_identities_revealed": false,
    "other_party_display_name": "FedRAMP-Authorized Cloud Migration SMB",
    "other_party_avatar_source": "AVATAR_SOURCE_ID"
  },
  "feedback_for_me": null,
  "feedback_from_other_party": null,
  "conversation_summary": null
}

Response Shape

Follow-up Behavior

Example

On this page