GovTribe

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.

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.