Set favorite MCP tool
Add or remove a record from your favorites (shown as Interested in tables). Adding a favorite also clears your Not interested dismissal. Removing a favorite never hides the record or changes a teammate’s decision.
- MCP tool name:
Set_Favorite - Returns: Set favorite MCP response
- Annotations: Not read only, destructive, idempotent, closed world
- Available in: GovTribe AI, GovTribe MCP
Favorites belong to the signed-in user, not the workspace. Setting a state that already applies is safe: favoriting a record that is already favorited returns the existing favorite without creating a duplicate, and unfavoriting a record that was never favorited returns the not-favorited state. That means you never need to check the current state before calling this tool.
Favorites appear as Interested in table views. Adding a favorite clears your own Not interested dismissal. Removing a favorite leaves the record visible and preserves your teammates’ decisions.
The tool is annotated destructive because favorited: false permanently removes a stored favorite. Repeating a call is still safe; the annotation reflects that one supported input deletes user data.
You can only favorite a record you can already view. Most types are public reference data, but user files are limited to your workspace, and contacts and gated assets can depend on your plan. Attempting to favorite a record outside your access returns an authorization error rather than a not-found error.
Supported govtribe_type values are contact, dod_acquisition_program, federal_agency, federal_contract_award, federal_contract_idv, federal_contract_opportunity, federal_contract_vehicle, federal_contract_vehicle_opportunity, federal_forecast, federal_grant_award, federal_grant_opportunity, federal_grant_program, federal_register_document, gated_asset, government_file, government_related_news_article, jurisdiction, naics_category, nigp_category, psc_category, state, state_local_contract_award, state_local_contract_idv, state_local_contract_opportunity, state_local_contract_vehicle, topic, unspsc_category, user_file, vendor. Passing any other type returns a validation error.
Before favoriting, confirm a favorite is what the customer wants. See Favorites, saved searches, and pursuits for when to save a query or open capture work instead.
Examples
Resolve the record first, then set its favorite state.
Favorite a vendor during market research
{
"tool": "Search_Vendors",
"arguments": {
"query": "shipboard electrical repair",
"fields_to_return": [
"govtribe_id",
"name"
]
}
}{
"tool": "Set_Favorite",
"arguments": {
"govtribe_type": "vendor",
"govtribe_id": "<vendor_govtribe_id>",
"favorited": true
}
}Favorite an agency to revisit later
{
"tool": "Set_Favorite",
"arguments": {
"govtribe_type": "federal_agency",
"govtribe_id": "<federal_agency_govtribe_id>",
"favorited": true
}
}Favorite a NAICS category that defines a core market
{
"tool": "Set_Favorite",
"arguments": {
"govtribe_type": "naics_category",
"govtribe_id": "<naics_category_govtribe_id>",
"favorited": true
}
}Remove a record from favorites when narrowing a shortlist
{
"tool": "Set_Favorite",
"arguments": {
"govtribe_type": "vendor",
"govtribe_id": "<vendor_govtribe_id>",
"favorited": false
}
}Reopen the favorites you just built
Every search tool for a favoritable record type accepts favorited, so you can read back the shortlist you have been building.
{
"tool": "Search_Vendors",
"arguments": {
"favorited": true,
"fields_to_return": [
"govtribe_id",
"name",
"location"
]
}
}Related articles
- Set favorite MCP response: Review the response shape returned by this tool.
Send teaming message
Operates in the cross-company GovTribe teaming network. Send a chat message as the user in a teaming conversation: pass teaming_match_id for a match conversation or teaming_interest_id (prime side) for the team-hub conversation. The other party is notified by email and in-app, and before a match is accepted vendor identities may still be masked to them. Messages cannot be edited or deleted by the agent. REQUIRED: show the user the exact message text and obtain their explicit confirmation before calling; content must be the user-approved text verbatim.
Show chart
Minimal: {"kind":"trend","rows":[{"month":"Jan","awards":3}],"labelKey":"month","series":[{"key":"awards"}]}. Render a read-only inline chart: `trend` renders 1–4 line series in supplied row order; `comparison` renders 1–4 grouped vertical bar series in supplied row order; `leaderboard` renders one horizontal bar series ranked descending. IDs and series labels default; titles, descriptions, colors, formatting and footnotes are optional. Descriptions appear once; omit them when no context is needed. Hover or focus a mark for its full label and value. Currency requires an explicit currency code; percent requires an explicit fraction/unit basis.