`homology`

Pack: ensembl · Endpoint: https://gateway.pipeworx.io/ensembl/mcp

“What’s the mouse / rat / zebrafish ortholog of [human gene]” / “ortholog of [gene] in [species]” / “homologs of [gene]” — orthologs and paralogs for a gene across species. Use for cross-species comparison, model organism work, evolutionary analysis.

Parameters

Name	Type	Required
`species`	string	yes
`symbol_or_id`	string	yes
`target_species`	string	no

Example call

Arguments

{
  "species": "human",
  "symbol_or_id": "BRAF",
  "target_species": "mus_musculus"
}

curl

curl -X POST https://gateway.pipeworx.io/ensembl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"homology","arguments":{"species":"human","symbol_or_id":"BRAF","target_species":"mus_musculus"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('homology', {
  "species": "human",
  "symbol_or_id": "BRAF",
  "target_species": "mus_musculus"
});

More examples

{
  "species": "human",
  "symbol_or_id": "ENSG00000157764",
  "target_species": "danio_rerio"
}

Response shape

Field	Type	Description
`data`	array	Homology records

Full JSON Schema

{
  "type": "object",
  "description": "Homology mappings for a gene",
  "properties": {
    "data": {
      "type": "array",
      "description": "Homology records",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Query gene ID"
          },
          "homologies": {
            "type": "array",
            "description": "Homologous genes",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Homolog ID"
                },
                "species": {
                  "type": "string",
                  "description": "Target species"
                },
                "type": {
                  "type": "string",
                  "description": "Homology type (ortholog/paralog)"
                },
                "perc_id": {
                  "type": "number",
                  "description": "Percent identity"
                },
                "perc_pos": {
                  "type": "number",
                  "description": "Percent positives"
                }
              }
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "ensembl": {
      "url": "https://gateway.pipeworx.io/ensembl/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

homology