GovTribe
MCP tools

Search contacts MCP tool

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

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.

Which contacts mention facility modernization?

{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "facility modernization",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "updated_at",
      "title",
      "govtribe_ai_summary"
    ]
  }
}

Which contacts exactly mention "technical support services"?

{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "\"technical support services\"",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}
{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "cybersecurity modernization, zero trust upgrades, network defense services",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "title",
      "updated_at"
    ]
  }
}

Which contacts are connected to Department of the Army?

{
  "tool": "Search_Federal_Agencies",
  "arguments": {
    "query": "Department of the Army",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "acronym"
    ]
  }
}
{
  "tool": "Search_Contacts",
  "arguments": {
    "federal_agency_ids": [
      "<department_of_the_army_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts are listed on a specific opportunity or award?

Pass the GovTribe IDs of the records that reference the contacts in referenced_govtribe_ids: federal contract opportunities, forecasts, grant opportunities, contract awards, and contract IDVs; state and local contract opportunities, IDVs, and vehicles; and government files. Resolve the record first when you only have a name or number. Pass up to 50 IDs per call.

A record that references no contacts returns zero results, and adding contact_ids, query, or reference_types cannot bring back unrelated contacts, so an empty result means GovTribe holds no contact reference for those IDs. An ID that is not a referencing record, such as a state, jurisdiction, agency, or federal contract vehicle ID, also returns zero results; for a federal contract vehicle, pass the IDs of its awards or IDVs instead. An empty list returns zero results too, so omit the argument when you are not filtering by referencing records. With the not_in operator, IDs that resolve to no contacts exclude nothing.

{
  "tool": "Search_Federal_Contract_Opportunities",
  "arguments": {
    "query": "facility modernization",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}
{
  "tool": "Search_Contacts",
  "arguments": {
    "referenced_govtribe_ids": [
      "<facility_modernization_opportunity_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts are connected to a specific state?

States are not referencing records, so find the state's state and local contract opportunities and pass those opportunity IDs to referenced_govtribe_ids. state_ids accepts a USPS code, so no state lookup is needed.

{
  "tool": "Search_State_And_Local_Contract_Opportunities",
  "arguments": {
    "state_ids": [
      "VA"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}
{
  "tool": "Search_Contacts",
  "arguments": {
    "referenced_govtribe_ids": [
      "<virginia_opportunity_govtribe_id_1>",
      "<virginia_opportunity_govtribe_id_2>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts are connected to a specific jurisdiction?

Jurisdictions are not referencing records either. Resolve the jurisdiction, find its state and local contract opportunities, and pass those opportunity IDs to referenced_govtribe_ids.

{
  "tool": "Search_Jurisdictions",
  "arguments": {
    "query": "Los Angeles County",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "fips_code"
    ]
  }
}
{
  "tool": "Search_State_And_Local_Contract_Opportunities",
  "arguments": {
    "jurisdiction_ids": [
      "<los_angeles_county_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}
{
  "tool": "Search_Contacts",
  "arguments": {
    "referenced_govtribe_ids": [
      "<los_angeles_county_opportunity_govtribe_id_1>",
      "<los_angeles_county_opportunity_govtribe_id_2>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts are connected to Advanced Technology International?

{
  "tool": "Search_Vendors",
  "arguments": {
    "query": "Advanced Technology International",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "uei"
    ]
  }
}
{
  "tool": "Search_Contacts",
  "arguments": {
    "vendor_ids": [
      "<advanced_technology_international_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts came from point-of-contact source references?

reference_types describes how a contact appears anywhere in GovTribe, not on one record. Combined with referenced_govtribe_ids, it returns contacts referenced by those records who also have that reference type on some record.

{
  "tool": "Search_Contacts",
  "arguments": {
    "reference_types": [
      "pointOfContact"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts have I favorited?

Pass favorited: true to limit results to contacts you saved during account research. Contacts have no heart control in GovTribe Web, so Set favorite is the only way to add one. Only true is supported; omit the argument to search everything.

{
  "tool": "Search_Contacts",
  "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 organizations are most represented among cybersecurity modernization contacts?

{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "\"cybersecurity modernization\"",
    "per_page": 0,
    "aggregations": [
      "top_federal_agencies_by_doc_count",
      "top_vendors_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}

Where are cybersecurity modernization contacts concentrated?

{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "\"cybersecurity modernization\"",
    "per_page": 0,
    "aggregations": [
      "top_jurisdictions_by_doc_count",
      "top_states_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}

Search contact groups

Searches GovTribe workspace contact groups and returns saved-search sync state, linked contacts, tags, and ownership fields.

Search custom field definitions

Searches the workspace's pursuit custom field definitions and returns each field's ID, name, type (text, number, date, or dollar), and whether it is required. Use the returned IDs as custom_field_id when reading or writing a pursuit's custom_fields.

On this page

ExamplesWhich contacts mention facility modernization?Which contacts exactly mention "technical support services"?Which contacts are conceptually related to cybersecurity modernization?Which contacts are connected to Department of the Army?Which contacts are listed on a specific opportunity or award?Which contacts are connected to a specific state?Which contacts are connected to a specific jurisdiction?Which contacts are connected to Advanced Technology International?Which contacts came from point-of-contact source references?Which contacts have I favorited?Aggregation examplesWhich organizations are most represented among cybersecurity modernization contacts?Where are cybersecurity modernization contacts concentrated?Related articles