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
- Available in: GovTribe AI, GovTribe MCP
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.
- Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.
Respond to teaming match
Operates in the cross-company GovTribe teaming network. Accept or decline a pending teaming match request. Only the recipient can respond. Use Withdraw_Teaming_Match if you are the requester wanting to cancel. Decline is recorded permanently — the same requester cannot re-request a match against this target interest, but the recipient remains free to initiate toward the requester. Confirm the match and the chosen response with the user before calling, especially for decline.
Search automations
Search GovTribe AI automations owned by the calling user. Optionally embed recent runs per automation.