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"
]
}
}Related articles
- 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.