GovTribe

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.

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"
    ]
  }
}