Search vendors MCP tool
Searches GovTribe vendor records and returns vendor profiles with identifiers, certifications, and related awards or grants.
- MCP tool name:
Search_Vendors - Data type: Vendor data type
- Returns: Vendor MCP response
- Search modes: Keyword, Semantic
- Annotations: Read only, not destructive, idempotent, closed world
- Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server (through Invoke Search Tool)
Examples
Use these examples as task-shaped tool calls. Examples may combine query, search_mode, filters, sorting, returned fields, resolver calls, and aggregations. When an example resolves a related record first, pass the returned govtribe_id into the target search.
Identifier filters
Use govtribe_ids for GovTribe vendor record IDs returned as govtribe_id. Use uei_values when the user gives vendor UEIs as public identifiers. The existing vendor_ids field remains supported and accepts GovTribe vendor IDs or UEIs. Use cage_codes for CAGE code filtering.
Which vendors mention facility modernization?
{
"tool": "Search_Vendors",
"arguments": {
"query": "facility modernization",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"updated_at",
"govtribe_ai_summary",
"govtribe_type"
]
}
}Which vendors exactly mention "technical support services"?
{
"tool": "Search_Vendors",
"arguments": {
"query": "\"technical support services\"",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors are conceptually related to cybersecurity modernization?
{
"tool": "Search_Vendors",
"arguments": {
"query": "cybersecurity modernization, zero trust upgrades, network defense services",
"search_mode": "semantic",
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have 8a certifications expiring in the next 12 months?
{
"tool": "Search_Vendors",
"arguments": {
"vendor_sba_8a_expiration_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have 8a joint venture certifications expiring in the next 12 months?
{
"tool": "Search_Vendors",
"arguments": {
"vendor_sba_8a_joint_venture_expiration_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendor registrations expire in the next 90 days?
{
"tool": "Search_Vendors",
"arguments": {
"registration_expiration_date_range": {
"from": "now/d",
"to": "now+90d/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have federal contract awards from a date range?
{
"tool": "Search_Vendors",
"arguments": {
"most_recent_federal_contract_award_date_range": {
"from": "now-12M/d",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have contract past performance in a specific industry category?
{
"tool": "Search_Naics_Categories",
"arguments": {
"query": "541512",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"code",
"name"
]
}
}{
"tool": "Search_Vendors",
"arguments": {
"vendor_primary_registered_naics_category_ids": [
"<naics_541512_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have contract past performance in a specific product or service category?
{
"tool": "Search_Psc_Categories",
"arguments": {
"query": "R499",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"code",
"name"
]
}
}{
"tool": "Search_Vendors",
"arguments": {
"vendor_registered_psc_category_ids": [
"<psc_r499_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have federal grant awards from a date range?
{
"tool": "Search_Vendors",
"arguments": {
"most_recent_federal_grant_award_date_range": {
"from": "now-12M/d",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have HUBZone certifications expiring in the next 12 months?
{
"tool": "Search_Vendors",
"arguments": {
"vendor_sba_hubzone_expiration_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors are located in Virginia?
{
"tool": "Search_Vendors",
"arguments": {
"vendor_location_ids": [
"Virginia"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors list NAICS 541512 as a primary registered category?
{
"tool": "Search_Naics_Categories",
"arguments": {
"query": "541512",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"code",
"name"
]
}
}{
"tool": "Search_Vendors",
"arguments": {
"vendor_primary_registered_naics_category_ids": [
"<naics_541512_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors registered since 2025?
{
"tool": "Search_Vendors",
"arguments": {
"registration_date_range": {
"from": "2025-01-01",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors are SBA Certified 8A Program Participants?
{
"tool": "Search_Vendors",
"arguments": {
"sba_certifications": [
"SBA Certified 8A Program Participant"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors self-certify as Service Disabled Veteran Owned Businesses?
{
"tool": "Search_Vendors",
"arguments": {
"business_types": [
"Service Disabled Veteran Owned Business"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have Small Disadvantaged certification expiration timing to review?
{
"tool": "Search_Vendors",
"arguments": {
"vendor_sba_small_disadvantaged_business_expiration_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"updated_at",
"govtribe_type"
]
}
}Which vendors have I favorited?
Pass favorited: true to limit results to vendors you saved while researching partners, competitors, or suppliers. Records enter that list through Set favorite or the heart control in GovTribe Web. Only true is supported; omit the argument to search everything.
{
"tool": "Search_Vendors",
"arguments": {
"favorited": true,
"fields_to_return": [
"govtribe_id",
"name"
]
}
}Aggregation examples
Use aggregation examples when the answer needs rollups instead of individual rows. These examples use quoted keyword anchors in query so long-tail matches do not skew buckets; broaden the query only when the user asks for exploratory sizing, and pair broader queries with structured filters when possible. Set per_page to 0 when row results are not needed.
Which categories define cybersecurity modernization vendors?
{
"tool": "Search_Vendors",
"arguments": {
"query": "\"cybersecurity modernization\"",
"per_page": 0,
"aggregations": [
"top_sba_certifications_by_doc_count",
"top_naics_codes_by_doc_count",
"top_psc_codes_by_doc_count"
],
"search_mode": "keyword"
}
}Where are cybersecurity modernization vendors concentrated?
{
"tool": "Search_Vendors",
"arguments": {
"query": "\"cybersecurity modernization\"",
"per_page": 0,
"aggregations": [
"top_locations_by_doc_count"
],
"search_mode": "keyword"
}
}Related articles
- Vendor MCP response: Review the response shape returned by this tool.
- Vendor data type: Understand the shared record fields and relationships used by this tool.
- Choose a search mode and write queries: Choose keyword or semantic search behavior and shape
queryvalues. - GovTribe AI: Review the GovTribe AI surface where this tool can be called.
- GovTribe for Agents: Use GovTribe for Agents as the starting point for MCP tools, MCP tool responses, and guides.
- MCP servers: Review where this MCP tool can be used.
- Invoke Search Tool MCP tool: Review where this MCP tool can be used.
- Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.
Search vector store
Semantic search files previously uploaded via `Add_To_Vector_Store`; for government & user files, not GovTribe docs.
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.