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, 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.

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

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

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.
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.

On this page