The Matchmaker Exchange (MME) API provides a shared language that databases can use to query each other to find similar patients. The API is build around a standardized patient profile that includes both phenotype and genotype information. Implementing the API involves parsing a query profile, identifying cases in your database that are similar, and returning a list of profiles for those cases.

Version 1.0 (latest release):

• API specification: blob/v1.0a/search-api.md
• Publication in Human Mutation: doi:10.1002/humu.22850

Development version (master branch):

• API specification: search-api.md

Have a question? Send us an email at [email protected] or create a GitHub issue.

• To query most MME services, you need to request an authentication token from that service. You can find a more detailed description here: join-protocol.md.
• To help securely share authentication tokens, the KEYS file contains GPG keys for at least one member of each MME team.

Below are a list of live implementations of the API, and the associated base URLs.

Here are the open-source implementations of the MME API that we are aware of:

1. MME reference server: https://github.com/MatchmakerExchange/reference-server. This implementation provides a concrete but simple example of one method for performing phenotype and gene-level matchmaking using an elasticsearch index.
2. Monarch Initiative: https://github.com/monarch-initiative/monarch-mme. This is an adapter that implements the MME API on top of existing Monarch APIs.
3. PhenomeCentral: https://github.com/phenotips/remote-matching. This package extends PhenoTips and PhenomeCentral to support the MME API.