Search Activity MCP tool

Searches GovTribe activity feed events for a subject record and optionally related records.

MCP tool name: Search_Activity
Data type: Activity data type
Returns: Activity 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 Search_Activity when the task asks what changed for a specific GovTribe record. Always pass the subject as govtribe_type and govtribe_id; the tool handles direct target matches, related-record matches, and pursuit-linked target matches internally.

The tool defaults to the most recent 60 days and requires any custom timestamp_range to include both from and to. The maximum custom window is 180 days.

What changed on this opportunity recently?

{
  "tool": "Search_Activity",
  "arguments": {
    "govtribe_type": "federal_contract_opportunity",
    "govtribe_id": "<opportunity_govtribe_id>",
    "fields_to_return": [
      "govtribe_id",
      "timestamp",
      "change_type",
      "changed_fields",
      "target",
      "actor",
      "match_scopes"
    ],
    "sort": {
      "key": "timestamp",
      "direction": "desc"
    }
  }
}

What activity touched a pursuit or its linked record?

{
  "tool": "Search_Activity",
  "arguments": {
    "govtribe_type": "pursuit",
    "govtribe_id": "<pursuit_govtribe_id>",
    "include_related": true,
    "timestamp_range": {
      "from": "2026-04-01T00:00:00Z",
      "to": "2026-06-01T23:59:59Z"
    },
    "fields_to_return": [
      "govtribe_id",
      "name",
      "timestamp",
      "activity_govtribe_type",
      "change_type",
      "changed_fields",
      "target",
      "match_scopes"
    ]
  }
}

Which fields changed most often?

{
  "tool": "Search_Activity",
  "arguments": {
    "govtribe_type": "vendor",
    "govtribe_id": "<vendor_govtribe_id>",
    "per_page": 0,
    "aggregations": [
      "changed_fields_by_doc_count",
      "change_types_by_doc_count",
      "timestamp_histogram"
    ]
  }
}

Which updates changed due date or estimated value?

{
  "tool": "Search_Activity",
  "arguments": {
    "govtribe_type": "pursuit",
    "govtribe_id": "<pursuit_govtribe_id>",
    "change_type": [
      "updated"
    ],
    "changed_fields": [
      "due_date",
      "estimated_value"
    ],
    "fields_to_return": [
      "govtribe_id",
      "timestamp",
      "change_type",
      "changed_fields",
      "objects",
      "target"
    ]
  }
}

Aggregation examples

Use per_page: 0 when the user only needs counts or timelines.

Count activity by target type and change type

{
  "tool": "Search_Activity",
  "arguments": {
    "govtribe_type": "federal_agency",
    "govtribe_id": "<federal_agency_govtribe_id>",
    "per_page": 0,
    "aggregations": [
      "activity_types_by_doc_count",
      "change_types_by_doc_count",
      "unknown_activity_by_doc_count"
    ]
  }
}

Activity MCP response: Review the response shape returned by this tool.
Activity data type: Understand the shared record fields and relationships used by this tool.
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