Create interest and request match MCP tool
In one call, create a new teaming interest for the acting user on a specific teamable record (opportunity via its meta wrapper, federal contract IDV, federal contract vehicle, federal forecast, or federal contract award) and immediately request a match against an existing target interest on the same record. Use Request_Teaming_Match if you already have an interest on the record. Triggers async AI summary generation; for opportunity-based interests it may also notify potential teaming partners.
- MCP tool name:
Create_Interest_And_Request_Match - Data type: Teaming match data type
- Returns: Teaming match MCP response
- Annotations: Not read only, destructive, not idempotent, closed world
- Surfaces: GovTribe AI
Examples
The arguments combine the Create teaming interest MCP tool payload with a target_interest_id. The new interest must be on the same teamable record as the target — any of the five teamable types, attached the same way you would attach it with the Create teaming interest MCP tool — and the two interests must have opposite intents. The call returns the pending match.
Discover a prime and join as a sub in one call
{
"tool": "Search_Teaming_Interests",
"arguments": {
"teamable_ids": ["<federal_meta_opportunity_govtribe_id>"],
"teaming_interest_intents": ["prime"],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"can_request_match"
]
}
}{
"tool": "Create_Interest_And_Request_Match",
"arguments": {
"name": "Cloud migration subcontracting interest",
"intent": "sub",
"teamable_model_class": "FederalMetaOpportunityModel",
"teamable_model_id": "<federal_meta_opportunity_govtribe_id>",
"vendor_model_id": "<vendor_govtribe_id>",
"intakeQuestions": {
"role_and_workshare": {
"question": "role_and_workshare",
"userInput": "We can lead the cloud migration workstream at roughly 20 percent workshare.",
"instructions": "Describe the role you want and the workshare you can perform."
},
"relevant_experience": {
"question": "relevant_experience",
"userInput": "Three prior agency cloud migrations of similar scope.",
"instructions": "Describe your relevant experience for this opportunity."
}
},
"target_interest_id": "<target_teaming_interest_govtribe_id>"
}
}Common precondition error codes: target_not_open when the target interest is no longer open and teamable_mismatch when the new interest and the target are on different teamable records.
Related articles
- Teaming match MCP response: Review the response shape returned by this tool.
- Teaming match 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.
- Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.
Create contact group
Create a GovTribe workspace contact group, optionally seeded with contacts and linked to a saved Contact search.
Create memories
Creates a durable user memory: the reusable way the user works that they would otherwise re-explain each conversation. Include a future expires_at date so the memory can be reviewed, reinforced, weakened, or pruned. Do not store facts that belong in a GovTribe record, ephemeral task details, or PII.