# Get funding request matches

`projects.get_matchmaking`

Read matching progress and saved choices. active_run is ongoing work; latest_run is the newest attempt; authoritative_run supplies visible results. Inspect is_stale before calculate, cancel or retry.

[Matchmaking guide](https://docs.levr.ai/mcp/resources/matchmaking.md)

Availability depends on live discovery and your access to the record. Do not infer MCP calls from REST paths.

Operation: read. Required OAuth scopes: mcp.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "provider_slug": {
      "description": "Copy provider_slug from providers.list; named slugs are valid.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "workspace_slug": {
      "description": "Matching workspace: copy workspace_slug (mmw_) from projects.get or projects.list; not project_slug.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "provider_slug",
    "workspace_slug"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "oneOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "properties": {
        "ok": {
          "const": true
        }
      },
      "required": [
        "data"
      ]
    },
    {
      "not": {
        "required": [
          "data"
        ]
      },
      "properties": {
        "ok": {
          "const": false
        }
      },
      "required": [
        "error"
      ]
    }
  ],
  "properties": {
    "data": {
      "additionalProperties": false,
      "properties": {
        "active_run": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "answers_revision": {
                  "anyOf": [
                    {
                      "description": "Revision of the matchmaking application answers, or null before they exist.",
                      "minimum": 0,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Revision of the matchmaking application answers, or null before they exist."
                },
                "attempt_sequence": {
                  "anyOf": [
                    {
                      "minimum": 1,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "coverage": {
                  "additionalProperties": false,
                  "properties": {
                    "cancelled": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "classification_counts": {
                      "additionalProperties": false,
                      "properties": {
                        "insufficient_information": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "match": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "not_a_match": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "not_assessed": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "partial_fit": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "match",
                        "partial_fit",
                        "insufficient_information",
                        "not_a_match",
                        "not_assessed"
                      ],
                      "type": "object"
                    },
                    "classify_completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "classify_total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "enrich_completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "enrich_total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "failed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "unresolved": {
                      "minimum": 0,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "total",
                    "completed",
                    "failed",
                    "cancelled",
                    "classification_counts",
                    "unresolved"
                  ],
                  "type": "object"
                },
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "impactful_missing_fields": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "affected_results": {
                        "minimum": 1,
                        "type": "integer"
                      },
                      "block_key": {
                        "type": "string"
                      },
                      "field_key": {
                        "type": "string"
                      },
                      "field_label": {
                        "type": "string"
                      },
                      "help_text": {
                        "type": "string"
                      },
                      "question_label": {
                        "type": "string"
                      },
                      "section_key": {
                        "type": "string"
                      },
                      "section_label": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "field_key",
                      "question_label",
                      "field_label",
                      "help_text",
                      "affected_results"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "is_publishable": {
                  "type": "boolean"
                },
                "is_stale": {
                  "type": "boolean"
                },
                "recovery": {
                  "additionalProperties": false,
                  "properties": {
                    "can_retry": {
                      "type": "boolean"
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "enum": [
                            "inputs_changed",
                            "running",
                            "complete"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "remaining": {
                      "additionalProperties": false,
                      "properties": {
                        "classify": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "enrich": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "classify",
                        "enrich"
                      ],
                      "type": "object"
                    },
                    "run_slug": {
                      "description": "Copy slug (pmrun_) from projects.get_matchmaking run summaries; for cancellation use active_run.slug.",
                      "maxLength": 255,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "run_slug",
                    "can_retry",
                    "reason",
                    "remaining"
                  ],
                  "type": "object"
                },
                "sequence": {
                  "minimum": 1,
                  "type": "integer"
                },
                "slug": {
                  "description": "Stable public identifier for the referenced resource.",
                  "maxLength": 255,
                  "minLength": 1,
                  "type": "string"
                },
                "state": {
                  "enum": [
                    "queued",
                    "running",
                    "partially_complete",
                    "completed",
                    "failed",
                    "cancelled"
                  ],
                  "type": "string"
                },
                "updated_at": {
                  "format": "date-time",
                  "type": "string"
                }
              },
              "required": [
                "slug",
                "sequence",
                "state",
                "coverage",
                "answers_revision",
                "recovery",
                "is_stale",
                "is_publishable",
                "impactful_missing_fields",
                "attempt_sequence",
                "created_at",
                "updated_at"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "answers_revision": {
          "anyOf": [
            {
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "authoritative_run": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "answers_revision": {
                  "anyOf": [
                    {
                      "description": "Revision of the matchmaking application answers, or null before they exist.",
                      "minimum": 0,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Revision of the matchmaking application answers, or null before they exist."
                },
                "attempt_sequence": {
                  "anyOf": [
                    {
                      "minimum": 1,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "coverage": {
                  "additionalProperties": false,
                  "properties": {
                    "cancelled": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "classification_counts": {
                      "additionalProperties": false,
                      "properties": {
                        "insufficient_information": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "match": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "not_a_match": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "not_assessed": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "partial_fit": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "match",
                        "partial_fit",
                        "insufficient_information",
                        "not_a_match",
                        "not_assessed"
                      ],
                      "type": "object"
                    },
                    "classify_completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "classify_total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "enrich_completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "enrich_total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "failed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "unresolved": {
                      "minimum": 0,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "total",
                    "completed",
                    "failed",
                    "cancelled",
                    "classification_counts",
                    "unresolved"
                  ],
                  "type": "object"
                },
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "impactful_missing_fields": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "affected_results": {
                        "minimum": 1,
                        "type": "integer"
                      },
                      "block_key": {
                        "type": "string"
                      },
                      "field_key": {
                        "type": "string"
                      },
                      "field_label": {
                        "type": "string"
                      },
                      "help_text": {
                        "type": "string"
                      },
                      "question_label": {
                        "type": "string"
                      },
                      "section_key": {
                        "type": "string"
                      },
                      "section_label": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "field_key",
                      "question_label",
                      "field_label",
                      "help_text",
                      "affected_results"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "is_publishable": {
                  "type": "boolean"
                },
                "is_stale": {
                  "type": "boolean"
                },
                "recovery": {
                  "additionalProperties": false,
                  "properties": {
                    "can_retry": {
                      "type": "boolean"
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "enum": [
                            "inputs_changed",
                            "running",
                            "complete"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "remaining": {
                      "additionalProperties": false,
                      "properties": {
                        "classify": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "enrich": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "classify",
                        "enrich"
                      ],
                      "type": "object"
                    },
                    "run_slug": {
                      "description": "Copy slug (pmrun_) from projects.get_matchmaking run summaries; for cancellation use active_run.slug.",
                      "maxLength": 255,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "run_slug",
                    "can_retry",
                    "reason",
                    "remaining"
                  ],
                  "type": "object"
                },
                "sequence": {
                  "minimum": 1,
                  "type": "integer"
                },
                "slug": {
                  "description": "Stable public identifier for the referenced resource.",
                  "maxLength": 255,
                  "minLength": 1,
                  "type": "string"
                },
                "state": {
                  "enum": [
                    "queued",
                    "running",
                    "partially_complete",
                    "completed",
                    "failed",
                    "cancelled"
                  ],
                  "type": "string"
                },
                "updated_at": {
                  "format": "date-time",
                  "type": "string"
                }
              },
              "required": [
                "slug",
                "sequence",
                "state",
                "coverage",
                "answers_revision",
                "recovery",
                "is_stale",
                "is_publishable",
                "impactful_missing_fields",
                "attempt_sequence",
                "created_at",
                "updated_at"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "deal_creation_setup": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "business_access_options": {
                  "items": {
                    "enum": [
                      "team_only",
                      "business_portal"
                    ],
                    "type": "string"
                  },
                  "type": "array"
                },
                "business_member_count": {
                  "minimum": 0,
                  "type": "integer"
                },
                "default_pipeline_id": {
                  "anyOf": [
                    {
                      "description": "Stable public identifier for the referenced resource.",
                      "maxLength": 255,
                      "minLength": 1,
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Stable public identifier for the referenced resource."
                },
                "pending_invitation_count": {
                  "minimum": 0,
                  "type": "integer"
                },
                "pipeline_count": {
                  "minimum": 0,
                  "type": "integer"
                },
                "pipelines": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "id": {
                        "description": "Stable public identifier for the referenced resource.",
                        "maxLength": 255,
                        "minLength": 1,
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "name"
                    ],
                    "type": "object"
                  },
                  "maxItems": 100,
                  "type": "array"
                },
                "requires_pipeline_choice": {
                  "description": "A pipeline id is required when several exist. The assistant may select an evidence-supported fit; ask the user when placement is ambiguous.",
                  "type": "boolean"
                },
                "sends_invitations": {
                  "type": "boolean"
                }
              },
              "required": [
                "pipelines",
                "pipeline_count",
                "default_pipeline_id",
                "requires_pipeline_choice",
                "business_access_options",
                "business_member_count",
                "pending_invitation_count",
                "sends_invitations"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "frontend_link": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "impactful_missing_fields": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "affected_results": {
                "minimum": 1,
                "type": "integer"
              },
              "block_key": {
                "type": "string"
              },
              "field_key": {
                "type": "string"
              },
              "field_label": {
                "type": "string"
              },
              "help_text": {
                "type": "string"
              },
              "question_label": {
                "type": "string"
              },
              "section_key": {
                "type": "string"
              },
              "section_label": {
                "type": "string"
              }
            },
            "required": [
              "field_key",
              "question_label",
              "field_label",
              "help_text",
              "affected_results"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "latest_run": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "answers_revision": {
                  "anyOf": [
                    {
                      "description": "Revision of the matchmaking application answers, or null before they exist.",
                      "minimum": 0,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Revision of the matchmaking application answers, or null before they exist."
                },
                "attempt_sequence": {
                  "anyOf": [
                    {
                      "minimum": 1,
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "coverage": {
                  "additionalProperties": false,
                  "properties": {
                    "cancelled": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "classification_counts": {
                      "additionalProperties": false,
                      "properties": {
                        "insufficient_information": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "match": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "not_a_match": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "not_assessed": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "partial_fit": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "match",
                        "partial_fit",
                        "insufficient_information",
                        "not_a_match",
                        "not_assessed"
                      ],
                      "type": "object"
                    },
                    "classify_completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "classify_total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "enrich_completed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "enrich_total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "failed": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "total": {
                      "minimum": 0,
                      "type": "integer"
                    },
                    "unresolved": {
                      "minimum": 0,
                      "type": "integer"
                    }
                  },
                  "required": [
                    "total",
                    "completed",
                    "failed",
                    "cancelled",
                    "classification_counts",
                    "unresolved"
                  ],
                  "type": "object"
                },
                "created_at": {
                  "format": "date-time",
                  "type": "string"
                },
                "impactful_missing_fields": {
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "affected_results": {
                        "minimum": 1,
                        "type": "integer"
                      },
                      "block_key": {
                        "type": "string"
                      },
                      "field_key": {
                        "type": "string"
                      },
                      "field_label": {
                        "type": "string"
                      },
                      "help_text": {
                        "type": "string"
                      },
                      "question_label": {
                        "type": "string"
                      },
                      "section_key": {
                        "type": "string"
                      },
                      "section_label": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "field_key",
                      "question_label",
                      "field_label",
                      "help_text",
                      "affected_results"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "is_publishable": {
                  "type": "boolean"
                },
                "is_stale": {
                  "type": "boolean"
                },
                "recovery": {
                  "additionalProperties": false,
                  "properties": {
                    "can_retry": {
                      "type": "boolean"
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "enum": [
                            "inputs_changed",
                            "running",
                            "complete"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "remaining": {
                      "additionalProperties": false,
                      "properties": {
                        "classify": {
                          "minimum": 0,
                          "type": "integer"
                        },
                        "enrich": {
                          "minimum": 0,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "classify",
                        "enrich"
                      ],
                      "type": "object"
                    },
                    "run_slug": {
                      "description": "Copy slug (pmrun_) from projects.get_matchmaking run summaries; for cancellation use active_run.slug.",
                      "maxLength": 255,
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "run_slug",
                    "can_retry",
                    "reason",
                    "remaining"
                  ],
                  "type": "object"
                },
                "sequence": {
                  "minimum": 1,
                  "type": "integer"
                },
                "slug": {
                  "description": "Stable public identifier for the referenced resource.",
                  "maxLength": 255,
                  "minLength": 1,
                  "type": "string"
                },
                "state": {
                  "enum": [
                    "queued",
                    "running",
                    "partially_complete",
                    "completed",
                    "failed",
                    "cancelled"
                  ],
                  "type": "string"
                },
                "updated_at": {
                  "format": "date-time",
                  "type": "string"
                }
              },
              "required": [
                "slug",
                "sequence",
                "state",
                "coverage",
                "answers_revision",
                "recovery",
                "is_stale",
                "is_publishable",
                "impactful_missing_fields",
                "attempt_sequence",
                "created_at",
                "updated_at"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "request_details": {
          "type": "object"
        },
        "revision": {
          "description": "Project revision required when changing saved recipient choices.",
          "minimum": 0,
          "type": "integer"
        },
        "selections": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "created_at": {
                "format": "date-time",
                "type": "string"
              },
              "deal_target_key": {
                "maxLength": 255,
                "minLength": 1,
                "type": "string"
              },
              "selected_package_version": {
                "minimum": 1,
                "type": "integer"
              },
              "updated_at": {
                "format": "date-time",
                "type": "string"
              }
            },
            "required": [
              "deal_target_key",
              "selected_package_version",
              "created_at",
              "updated_at"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "workspace_revision": {
          "minimum": 0,
          "type": "integer"
        },
        "workspace_slug": {
          "description": "Stable public identifier for the referenced resource.",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "workspace_slug",
        "frontend_link",
        "answers_revision",
        "latest_run",
        "active_run",
        "authoritative_run",
        "revision",
        "impactful_missing_fields",
        "selections"
      ],
      "type": "object"
    },
    "error": {
      "additionalProperties": false,
      "properties": {
        "code": {
          "type": "string"
        },
        "details": {
          "additionalProperties": true,
          "description": "Optional bounded, agent-safe correction or recovery facts.",
          "type": "object"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        }
      },
      "required": [
        "code",
        "message",
        "retryable"
      ],
      "type": "object"
    },
    "meta": {
      "additionalProperties": false,
      "properties": {
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "request_id"
      ],
      "type": "object"
    },
    "ok": {
      "description": "Whether the tool completed successfully.",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "meta"
  ],
  "type": "object"
}
```