Search contacts MCP tool

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

MCP tool name: Search_Contacts
Data type: Contact data type
Returns: Contact MCP response
Search modes: Keyword, Semantic
Annotations: Read only, not destructive, idempotent, closed world
Surfaces: GovTribe AI, GovTribe MCP

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 connected to a specific state?

{
  "tool": "Search_States",
  "arguments": {
    "query": "Virginia",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "usps_code"
    ]
  }
}

{
  "tool": "Search_Contacts",
  "arguments": {
    "referenced_govtribe_ids": [
      "<virginia_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "title",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which contacts are connected to a specific jurisdiction?

{
  "tool": "Search_Jurisdictions",
  "arguments": {
    "query": "Los Angeles County",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "fips_code"
    ]
  }
}

{
  "tool": "Search_Contacts",
  "arguments": {
    "referenced_govtribe_ids": [
      "<los_angeles_county_govtribe_id>"
    ],
    "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?

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

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

Contact MCP response: Review the response shape returned by this tool.
Contact 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 query values.
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.
Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.

On this page