GovTribe
MCP tools

Set favorite MCP tool

Add or remove a GovTribe record from the current user favorites. Favorites are a lightweight, record-level shortlist for later review. Use a saved search for a reusable query, and a pursuit for active capture work.

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.

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_vehicle, federal_grant_program, gated_asset, government_file, government_related_news_article, jurisdiction, naics_category, nigp_category, psc_category, state, state_local_contract_vehicle, topic, unspsc_category, user_file, and 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"
    ]
  }
}

Send teaming message

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

Render a read-only inline chart as a standard `trend`, `comparison`, or `leaderboard` view from structured rows and series data.

On this page

ExamplesFavorite a vendor during market researchFavorite an agency to revisit laterFavorite a NAICS category that defines a core marketRemove a record from favorites when narrowing a shortlistReopen the favorites you just builtRelated articles