Search states MCP tool

• MCP tool name: Search_States
• Data type: State data type
• Returns: State MCP response
• Search modes: Keyword
• 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 state record IDs returned as govtribe_id. The existing state_ids field also accepts a GovTribe state ID, a case-insensitive USPS code, or a full state or territory name. Prefer a returned govtribe_id; see Location filtering for unique-match and error-repair behavior.

Which states mention facility modernization?

{
  "tool": "Search_States",
  "arguments": {
    "query": "facility modernization",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "updated_at",
      "govtribe_type",
      "govtribe_url"
    ]
  }
}

Which states exactly mention "technical support services"?

{
  "tool": "Search_States",
  "arguments": {
    "query": "\"technical support services\"",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "updated_at",
      "govtribe_type",
      "govtribe_url"
    ]
  }
}

Related articles

• State MCP response: Review the response shape returned by this tool.
• State 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.