Available MCP Tools

This page documents the tools currently available in the GovTribe MCP (Beta) server.

GovTribe MCP tools fall into three categories:

• Documentation Tools

• Search Tools

• User Account Action Tools

---

For testing tools, we recommend using the MCP Inspector which allows you to manually call all the tools with configurable arguments.

---

Tool Catalog

Documentation Tools

You should not have to manually call any documentation MCP tools; the goal is that AI reads these into the context window on its own when required.

Search Instructions

Tool Name

Search_Instructions

Description

This tool must be called BEFORE using any other GovTribe search operation, no matter how simple or basic. It is mandatory and must always be invoked first in every interaction involving any GovTribe search tool, without exception. No search tool (Search_Pipelines, Search_Pursuits, Search_Opportunities, etc.) may be called until this tool has been called in the current conversation context.

Parameters

Parameter	Type	Rules
None

Output

Documentation: Search Best Practices

Search Tools

Most search tools share these “core” fields:

• query (string)

• page (number)

• per_page (number)

• search_mode ("keyword" or "semantic")

• plus tool-specific filters (IDs, date ranges, operators, etc.) + operators (e.g. Include, Exclude)

Federal Contracting

Search Federal Agencies Tool

Tool Name

Search_Federal_Agencies

Description

Searches GovTribe federal agency records and returns agency profiles with identifiers, classifications, and URLs.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Federal Contract Awards Tool

Tool Name

Search_Federal_Contract_Awards

Description

Searches GovTribe federal contract awards and returns award records with funding details, participants, and category links.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
award_date_range	object	Required
ceiling_value_range	object	Required
contact_ids	array	Required, Items: string
contracting_federal_agency_ids	array	Required, Items: string
dollars_obligated_range	object	Required
federal_contract_award_types	array	Required, Items: string
federal_contract_idv_ids	array	Required, Items: string
federal_contract_vehicle_ids	array	Required, Items: string
federal_meta_opportunity_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
naics_category_ids	array	Required, Items: string
place_of_performance_ids	array	Required, Items: string
psc_category_ids	array	Required, Items: string
query	string	Required
research_phase	array	Required, Items: string
search_mode	string	Required, Default: "keyword"
set_aside_types	array	Required, Items: string
sort	object	Required
sub_vendor_ids	array	Required, Items: string
ultimate_completion_date_range	object	Required
vendor_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
contracting_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_award_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_idv_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_vehicle_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_meta_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
naics_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
place_of_performance_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
psc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
research_phase_operator	string | null	Default: "in", Enum ["in", "not_in"]
set_aside_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
sub_vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Contract IDVs Tool

Tool Name

Search_Federal_Contract_IDVs

Description

Searches GovTribe federal contract IDVs and returns vehicle records with ceilings, awardees, agencies, and related awards.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
award_date_range	object	Required
ceiling_value_range	object	Required
contact_ids	array	Required, Items: string
contracting_federal_agency_ids	array	Required, Items: string
federal_contract_idv_types	array	Required, Items: string
federal_contract_vehicle_ids	array	Required, Items: string
federal_meta_opportunity_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
last_date_to_order_range	object	Required
multiple_or_single_award	array	Required, Items: string
naics_category_ids	array	Required, Items: string
psc_category_ids	array	Required, Items: string
query	string	Required
research_phase	array	Required, Items: string
search_mode	string	Required, Default: "keyword"
set_aside_types	array	Required, Items: string
sort	object	Required
vendor_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
contracting_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_idv_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_vehicle_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_meta_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
multiple_or_single_award_operator	string | null	Default: "in", Enum ["in", "not_in"]
naics_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
psc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
research_phase_operator	string | null	Default: "in", Enum ["in", "not_in"]
set_aside_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Contract Opportunities Tool

Tool Name

Search_Federal_Contract_Opportunities

Description

Searches GovTribe federal contract opportunities and returns solicitation records with requirements, timelines, files, and contacts.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
contact_ids	array	Required, Items: string
due_date_range	object	Required
federal_agency_ids	array	Required, Items: string
federal_meta_opportunity_ids	array	Required, Items: string
ids	array	Required, Items: string
naics_category_ids	array	Required, Items: string
opportunity_types	array	Required, Items: string
place_of_performance_ids	array	Required, Items: string
posted_date	object	Required
psc_category_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
set_aside_types	array	Required, Items: string
sort	object	Required
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_meta_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
naics_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
opportunity_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
place_of_performance_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
psc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
set_aside_types_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Contract Sub Awards Tool

Tool Name

Search_Federal_Contract_Sub_Awards

Description

Searches GovTribe federal contract sub-awards and returns subcontract records with amounts, primes, subs, and agency context.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
award_date_range	object	Required
contracting_federal_agency_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
vendor_ids	array	Required, Items: string
contracting_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Contract Vehicles Tool

Tool Name

Search_Federal_Contract_Vehicles

Description

Searches GovTribe federal contract vehicles and returns vehicle records with scope, ordering windows, and linked awards.

Parameters

Parameter	Type	Rules
award_date_range	object	Required
federal_contract_vehicle_types	array	Required, Items: string
federal_meta_opportunity_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
last_date_to_order_range	object	Required
query	string	Required
search_mode	string	Required, Default: "keyword"
shared_ceiling_value_range	object	Required
sort	object	Required
vendor_ids	array	Required, Items: string
federal_contract_vehicle_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_meta_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Forecasts Tool

Tool Name

Search_Federal_Forecasts

Description

Searches GovTribe federal forecasts and returns planned requirement records with estimates, timelines, and contacts.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
anticipated_award_start_date_range	object	Required
contact_ids	array	Required, Items: string
estimated_solicitation_release_date_range	object	Required
federal_agency_ids	array	Required, Items: string
forecast_type	array	Required, Items: string
ids	array	Required, Items: string
naics_category_ids	array	Required, Items: string
place_of_performance_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
set_aside_types	array	Required, Items: string
sort	object	Required
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
forecast_type_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
naics_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
place_of_performance_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
set_aside_types_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Transactions Tool

Tool Name

Search_Federal_Transactions

Description

Searches GovTribe federal contract transactions and returns FPDS transaction lines with financial amounts, agencies, and vendors.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
contracting_federal_agency_ids	array	Required, Items: string
federal_contract_award_ids	array	Required, Items: string
federal_contract_idv_ids	array	Required, Items: string
federal_contract_vehicle_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
naics_category_ids	array	Required, Items: string
psc_category_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
set_aside_types	array	Required, Items: string
sort	object	Required
transaction_ids	array	Required, Items: string
vendor_ids	array	Required, Items: string
contracting_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_award_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_idv_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_vehicle_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
naics_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
psc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
set_aside_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
transaction_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Grants

Search Federal Grant Awards Tool

Tool Name

Search_Federal_Grant_Awards

Description

Searches GovTribe federal grant awards and returns award records with funding amounts, recipients, and program metadata.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
assistance_types	array	Required, Items: string
award_date_range	object	Required
contracting_federal_agency_ids	array	Required, Items: string
dollars_obligated_range	object	Required
federal_grant_program_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
place_of_performance_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
ultimate_completion_date_range	object	Required
vendor_ids	array	Required, Items: string
assistance_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
contracting_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_grant_program_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
place_of_performance_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Federal Grant Opportunities Tool

Tool Name

Search_Federal_Grant_Opportunities

Description

Searches GovTribe federal grant opportunities and returns opportunity records with eligibility, deadlines, and supporting files.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
contact_ids	array	Required, Items: string
due_date_range	object	Required
federal_agency_ids	array	Required, Items: string
federal_grant_program_ids	array	Required, Items: string
funding_activity_categories	array	Required, Items: string
funding_instrument_types	array	Required, Items: string
ids	array	Required, Items: string
opportunity_types	array	Required, Items: string
posted_date	object	Required
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_grant_program_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_activity_categories_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_instrument_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
opportunity_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Federal Grant Programs Tool

Tool Name

Search_Federal_Grant_Programs

Description

Searches GovTribe federal grant programs and returns ALN program records with identifiers, descriptions, and related opportunities.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Federal Grant Sub Awards Tool

Tool Name

Search_Federal_Grant_Sub_Awards

Description

Searches GovTribe federal grant sub-awards and returns pass-through grant records with amounts, prime recipients, and sub-recipients.

Parameters

Parameter	Type	Rules
award_date_range	object	Required
contracting_federal_agency_ids	array	Required, Items: string
funding_federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
vendor_ids	array	Required, Items: string
contracting_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
funding_federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
vendor_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

State & Local

If your account does not have access to State & Local data, these tools will not be available.

Search State And Local Contract Awards Tool

Tool Name

Search_State_And_Local_Contract_Awards

Description

Searches GovTribe state and local contract awards and returns award records with values, winners, and supporting materials.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
award_date_range	object	Required
contact_ids	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
state_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
state_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search State And Local Contract IDVs Tool

Tool Name

Search_State_And_Local_Contract_IDVs

Description

Searches GovTribe state and local contract IDVs and returns vehicle records with terms, awardees, and related awards.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
award_date_range	object	Required
contact_ids	array	Required, Items: string
ids	array	Required, Items: string
nigp_category_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
state_ids	array	Required, Items: string
unspsc_category_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
nigp_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
state_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
unspsc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search State And Local Contract Opportunities Tool

Tool Name

Search_State_And_Local_Contract_Opportunities

Description

Searches GovTribe state and local contract opportunities and returns solicitation records with schedules, contacts, and category tags.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
contact_ids	array	Required, Items: string
due_date_range	object	Required
ids	array	Required, Items: string
jurisdiction_ids	array	Required, Items: string
nigp_category_ids	array	Required, Items: string
posted_date	object	Required
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
state_ids	array	Required, Items: string
unspsc_category_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
jurisdiction_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
nigp_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
state_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
unspsc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search State And Local Contract Vehicles Tool

Tool Name

Search_State_And_Local_Contract_Vehicles

Description

Searches GovTribe state and local contract vehicles and returns vehicle records with scope, timelines, and related IDVs.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
award_date_range	object	Required
contact_ids	array	Required, Items: string
ids	array	Required, Items: string
nigp_category_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
state_ids	array	Required, Items: string
unspsc_category_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
nigp_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
state_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
unspsc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Entities, Categories, and Supporting Content

Search Contacts Tool

Tool Name

Search_Contacts

Description

Searches GovTribe contact records and returns profiles with communication details and linked organizations.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Government Files Tool

Tool Name

Search_Government_Files

Description

Searches GovTribe government files and returns document metadata with optional text extracts; prefer file_search when vector stores exist.

Parameters

Parameter	Type	Rules
contact_ids	array	Required, Items: string
external_file_ids	array	Required, Items: string
federal_contract_idv_ids	array	Required, Items: string
federal_contract_opportunity_ids	array	Required, Items: string
federal_grant_opportunity_ids	array	Required, Items: string
ids	array	Required, Items: string
jurisdiction_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
state_ids	array	Required, Items: string
state_local_contract_opportunity_ids	array	Required, Items: string
contact_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
external_file_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_idv_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_contract_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
federal_grant_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
jurisdiction_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
state_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
state_local_contract_opportunity_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Government Related News Articles Tool

Tool Name

Search_Government_Related_News_Articles

Description

Searches GovTribe government-related news articles and returns article records with headlines, sources, and body text.

Parameters

Parameter	Type	Rules
article_ids	array	Required, Items: string
date_published	object	Required
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
sort	object	Required
article_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Jurisdictions Tool

Tool Name

Search_Jurisdictions

Description

Searches GovTribe jurisdiction records and returns profiles with names, FIPS codes, and hierarchy metadata.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
state_ids	array	Required, Items: string
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
state_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Major Defense Programs Tool

Tool Name

Search_Major_Defense_Programs

Description

Searches GovTribe major defense programs and returns program records with codes, acquisition data, and related awards.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
federal_agency_ids	array	Required, Items: string
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
federal_agency_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search NAICS Categories Tool

Tool Name

Search_Naics_Categories

Description

Searches GovTribe NAICS categories and returns category records with codes, names, and linked federal opportunities.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search NIGP Categories Tool

Tool Name

Search_Nigp_Categories

Description

Searches GovTribe NIGP categories and returns category records with codes, names, and related state or local opportunities.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search PSC Categories Tool

Tool Name

Search_Psc_Categories

Description

Searches GovTribe PSC categories and returns category records with codes, names, and linked federal awards.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search States Tool

Tool Name

Search_States

Description

Searches GovTribe state records and returns state profiles with names, USPS codes, and canonical URLs.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search UNSPSC Categories Tool

Tool Name

Search_Unspsc_Categories

Description

Searches GovTribe UNSPSC categories and returns category records with codes, names, and linked state or local opportunities.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Vendors Tool

Tool Name

Search_Vendors

Description

Searches GovTribe vendor records and returns vendor profiles with identifiers, certifications, and related awards or grants.

Parameters

Parameter	Type	Rules
aggregations	array	Required, Items: string
business_types	array	Required, Items: string
ids	array	Required, Items: string
most_recent_federal_contract_award_date_range	object	Required
most_recent_federal_grant_award_date_range	object	Required
query	string	Required
registration_date_range	object	Required
registration_expiration_date_range	object	Required
sba_certifications	array	Required, Items: string
search_mode	string	Required, Default: "keyword"
sort	object	Required
vendor_location_ids	array	Required, Items: string
vendor_primary_registered_naics_category_ids	array	Required, Items: string
vendor_registered_psc_category_ids	array	Required, Items: string
business_types_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
sba_certifications_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_location_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_primary_registered_naics_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
vendor_registered_psc_category_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

User Account Search Tools

These search tools are specific to your GovTribe workspace, and help you find objects you might want to update via action tools:

Search Pipelines Tool

Tool Name

Search_Pipelines

Description

Searches GovTribe pipelines and returns pipeline records with owners, stages, and URLs.

Parameters

Parameter	Type	Rules
creator_ids	array	Required, Items: string
ids	array	Required, Items: string
owner_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
creator_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
owner_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Pursuits Tool

Tool Name

Search_Pursuits

Description

Searches GovTribe pursuits and returns pursuit records with pipeline placement, owners, linked items, and attachments.

Parameters

Parameter	Type	Rules
creator_ids	array	Required, Items: string
ids	array	Required, Items: string
owner_ids	array	Required, Items: string
pipeline_ids	array	Required, Items: string
pursuit_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
stage_ids	array	Required, Items: string
creator_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
owner_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
pipeline_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
pursuit_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
stage_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Saved Searches Tool

Tool Name

Search_Saved_Searches

Description

Searches saved searches and returns saved query definitions with filters, cadence, and links.

Parameters

Parameter	Type	Rules
creator_ids	array	Required, Items: string
ids	array	Required, Items: string
owner_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
creator_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
owner_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Stages Tool

Tool Name

Search_Stages

Description

Searches pipeline stages and returns stage records with owners, pipeline context, and stage metadata.

Parameters

Parameter	Type	Rules
creator_ids	array	Required, Items: string
ids	array	Required, Items: string
owner_ids	array	Required, Items: string
pipeline_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
creator_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
owner_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
pipeline_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search Tasks Tool

Tool Name

Search_Tasks

Description

Searches GovTribe tasks and returns task records with pipeline context, owners, and linked pursuits.

Parameters

Parameter	Type	Rules
creator_ids	array	Required, Items: string
ids	array	Required, Items: string
owner_ids	array	Required, Items: string
pipeline_ids	array	Required, Items: string
pursuit_ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
creator_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
owner_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1
pipeline_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
pursuit_ids_operator	string | null	Default: "in", Enum ["in", "not_in"]

Search User Files Tool

Tool Name

Search_User_Files

Description

Searches team-uploaded files and returns file metadata, summaries, and optional extracted text; prefer file_search when a vector store is attached.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Search Users Tool

Tool Name

Search_Users

Description

Searches GovTribe workspace users by name or email and returns matching user records.

Parameters

Parameter	Type	Rules
ids	array	Required, Items: string
query	string	Required
search_mode	string	Required, Default: "keyword"
ids_operator	string | null	Default: "in", Enum ["in", "not_in"]
page	number | null	Min: 1
per_page	number | null	Min: 1

Account Action Tools

These tools change workspace state (pipelines, pursuits, tasks, etc.). Use with care. Any plan-level limits you have in GovTribe will be enforced via these tools as well.

Pipelines & Stages

Create Pipeline Tool

Tool Name

Create_Pipeline

Description

Create a GovTribe pipeline.

Parameters

Parameter	Type	Rules
name	string	Required, MaxLength: 100
stageCount	integer	Required, Default: 3, Min: 1, Max: 99
description	string	MaxLength: 1000

Create Stage Tool

Tool Name

Create_Stage

Description

Create a GovTribe stage.

Parameters

Parameter	Type	Rules
name	string	Required, MinLength: 1, MaxLength: 50
pipeline_id	string	Required
description	string	MinLength: 1, MaxLength: 1000
index	integer	Min: 0, Max: 996

Delete Pipeline Tool

Tool Name

Delete_Pipeline

Description

Delete a GovTribe pipeline & all of its Pursuits.

Parameters

Parameter	Type	Rules
pipeline_id	string	Required

Delete Stage Tool

Tool Name

Delete_Stage

Description

Delete a GovTribe stage.

Parameters

Parameter	Type	Rules
stage_id	string	Required

Update Pipeline Tool

Tool Name

Update_Pipeline

Description

Update a GovTribe pipeline.

Parameters

Parameter	Type	Rules
name	string	Required, MaxLength: 100
pipeline_id	string	Required
description	string	MaxLength: 1000

Update Stage Tool

Tool Name

Update_Stage

Description

Update a GovTribe stage.

Parameters

Parameter	Type	Rules
pursuit_index_map	array	Required, Items: object
stage_id	string	Required
description	string	MinLength: 1, MaxLength: 1000
index	integer	Min: 0, Max: 996
name	string	MinLength: 1, MaxLength: 50

Pursuits

Create Pursuit Tool

Tool Name

Create_Pursuit

Description

Creates a new pursuit in the specified stage, optionally seeding fields from a linked item.

Parameters

Parameter	Type	Rules
stage_id	string	Required
description	string	MinLength: 0
dueDate	string
estimatedAwardDate	string
estimatedDuration	integer	Min: 0
estimatedValue	integer	Min: 0
linked_item_id	string
linked_item_model_class	string	Enum ["ContactGroupModel", "ContactModel", "FederalContractAwardModel", "FederalContractIDVModel", "FederalContractOpportunityModel", "FederalForecastModel", "FederalGrantAwardModel", "FederalGrantOpportunityModel", "FederalGrantProgramModel", "JurisdictionModel", "NIGPCategoryModel", "StateLocalContractOpportunityModel", "StateLocalContractAwardModel", "StateLocalContractIDVModel", "StateLocalContractVehicleModel", "UNSPSCCategoryModel", "FederalAgencyModel", "FederalContractVehicleModel", "NAICSCategoryModel", "PSCCategoryModel", "StateModel"]
name	string	MinLength: 1, MaxLength: 255
pwin	integer	Min: 1, Max: 100

Delete Pursuit Tool

Tool Name

Delete_Pursuit

Description

Deletes a pursuit.

Parameters

Parameter	Type	Rules
pursuit_id	string	Required

Update Pursuit Tool

Tool Name

Update_Pursuit

Description

Update a GovTribe pursuit.

Parameters

Parameter	Type	Rules
pursuit_id	string	Required
description	string	MinLength: 0
dueDate	string
estimatedAwardDate	string
estimatedDuration	integer	Min: 0
estimatedValue	integer	Min: 0
name	string	MinLength: 1, MaxLength: 255
pwin	integer	Min: 0, Max: 100
stage_id	string

Tasks

Create Task Tool

Tool Name

Create_Task

Description

Creates a new task in the specified pipeline and pursuit.

Parameters

Parameter	Type	Rules
dueDate	string	Required
name	string	Required, MinLength: 1, MaxLength: 100
owner_model_id	string	Required
pipeline_id	string	Required
pursuit_id	string	Required
description	string	MaxLength: 10000
priority	string	Enum ["low", "medium", "high", "urgent"]

Delete Task Tool

Tool Name

Delete_Task

Description

Deletes a task.

Parameters

Parameter	Type	Rules
task_id	string	Required

Update Task Tool

Tool Name

Update_Task

Description

Updates an existing task with the provided fields.

Parameters

Parameter	Type	Rules
pipeline_id	string	Required
pursuit_id	string	Required
task_id	string	Required
comment	string	MaxLength: 1000
description	string	MaxLength: 10000
dueDate	string
name	string	MinLength: 1, MaxLength: 100
owner_model_id	string
priority	string	Enum ["low", "medium", "high", "urgent"]

Saved Searches

Create Saved Search Tool

Tool Name

Create_Saved_Search

Description

Creates a saved search from a search_* persistence ID with a name and optional email notifications at custom frequencies.

Parameters

Parameter	Type	Rules
frequency	string	Required, Default: "Daily", Enum ["Daily", "Weekly", "Instant", "Never"]
name	string	Required, MinLength: 1, MaxLength: 100
search_persistence_id	string	Required

Delete Saved Search Tool

Tool Name

Delete_Saved_Search

Description

Delete a GovTribe saved search.

Parameters

Parameter	Type	Rules
saved_search_id	string	Required

Update Saved Search Tool

Tool Name

Update_Saved_Search

Description

Update a GovTribe saved search.

Parameters

Parameter	Type	Rules
saved_search_id	string	Required
frequency	string	Enum ["Daily", "Weekly", "Instant", "Never"]
name	string	MinLength: 1, MaxLength: 100

---

Tool-Calling Conventions

These are rules followed by most tools, and are documented within the "Search Instructions" tool. The AI will automatically educate itself using these guidelines.

Required fields + “empty defaults”

Many GovTribe MCP tools (especially search tools) expect a complete JSON payload. If you’re not using a filter, send the field with an “empty default” value.

Use these defaults when you don’t have a value:

• Strings: ""

• Arrays: []

• Date ranges: { "from": null, "to": null }

• Numeric ranges: { "min": null, "max": null }

• Sort objects: { "key": "_score", "direction": "desc" }

IDs (*_ids) are GovTribe IDs

Any field ending in *_ids expects GovTribe IDs (not names). Pass the govtribe_id exactly as returned by a prior search.

search_mode: keyword vs semantic

• Use keyword when you need exact-ish matching (IDs, solicitation numbers, titles), OR when you need aggregations (“top vendors”, “by NAICS”, etc.).

  • Keyword supports:

    • quoted phrases: "enterprise cyber range"

    • OR: term1 | term2

    • exclude: -term

• Use semantic for conceptual searches (“similar opportunities to…”, “cloud modernization set-aside examples”, etc.).

  • Semantic does not support boolean operators like OR / AND.

---

Example Usage

Federal Contract Opportunities (input + output)

Example request (JSON)

{
  "query": "cyber",
  "page": 1,
  "per_page": 3,
  "search_mode": "keyword",
  "due_date_range": { "from": null, "to": null },
  "posted_date": { "from": null, "to": null },

  "federal_agency_ids": [],
  "federal_agency_ids_operator": "in",
  "naics_category_ids": [],
  "naics_category_ids_operator": "in",
  "psc_category_ids": [],
  "psc_category_ids_operator": "in",
  "place_of_performance_ids": [],
  "place_of_performance_ids_operator": "in",

  "contact_ids": [],
  "contact_ids_operator": "in",
  "federal_meta_opportunity_ids": [],
  "federal_meta_opportunity_ids_operator": "in",

  "opportunity_types": [],
  "opportunity_types_operator": "in",
  "set_aside_types": [],
  "set_aside_types_operator": "in",

  "ids": [],
  "ids_operator": "in",
  "aggregations": [],
  "sort": { "key": "_score", "direction": "desc" }
}

Example response (JSON, truncated)

{
  "current_page": 1,
  "per_page": 3,
  "total": 10000,
  "search_results_id_can_generate_saved_search": true,
  "search_results_id": "5dbde582a1c4c52c9a5919a5",
  "view_search_results_url": "https://govtribe.com/opportunity/federal-contract-opportunity?searchId=5dbde582a1c4c52c9a5919a5&utm_source=ai_insights",
  "data": [
    {
      "govtribe_id": "d89299475f2b4e5dbcfe96bed42653ff",
      "govtribe_type": "federal_contract_opportunity",
      "solicitation_number": "DCSA_CYBERSSN_25",
      "name": "DCSA Enterprise Cybersecurity Support Services",
      "govtribe_url": "https://govtribe.com/opportunity/federal-contract-opportunity/dcsa-enterprise-cybersecurity-support-services-dcsacyberssn25",
      "opportunity_type": "Pre-Solicitation",
      "set_aside_type": "Competitive 8(a)",
      "posted_date": "2025-04-22T19:33:01Z",
      "due_date": "2025-05-20T21:00:00Z"
    }
  ]
}

Tip: when search_results_id_can_generate_saved_search is true, you can typically use search_results_id to create a Saved Search via Create_Saved_Search.

---

Common errors & fixes

• Error: missing required fields

  • Fix: include the full payload shape; when you don’t want to filter, use the empty defaults above.

• Error: used OR / AND in keyword queries

  • Fix: keyword mode uses | for OR (example: "cmmc" | "zero trust"). Do not use OR.

• No results when filtering by agency/vendor “name”

  • Fix: resolve the entity first using the relevant search tool (e.g., search agencies/vendors), then pass their govtribe_id into the *_ids filter.