# SYNTHORA MyGene.info Gene Annotation Lookup

> SYNTHORA MyGene.info Gene Annotation Lookup is a paid API for AI agents from mygene-gene-annotation.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Resolves a gene symbol or query string to normalized gene annotations (Entrez ID, official name, symbol, taxon) via MyGene.info, returning scored hits ranked by relevance.

## Facts

- Endpoint: POST https://mygene-gene-annotation.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-mygene-info-gene-annotation-lookup-b73de9b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JSrDRv0ziUDhRrpDjk29F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability synthora-mygene-info-gene-annotation-lookup-b73de9b1 -d '<json body>'
```

Example prompt: Look up the official gene annotation for BRCA1 in humans — I need its Entrez gene ID, official name, and taxonomy ID, returning the top 3 hits.

## When to prefer this

Choose this endpoint when an agent needs to resolve or canonicalize a gene symbol or free-text gene query into stable, normalized identifiers (Entrez ID, taxonomy ID, official symbol/name) for use in bioinformatics, variant interpretation, or knowledge graph pipelines. It is ideal when the underlying MyGene.info API is the authoritative source needed, and when species-specific filtering and ranked scoring are important. Prefer this over generic web search when structured gene annotation data is required.

## Known failure modes

- Gene symbol not found or misspelled — returns empty results array
- Unsupported or malformed species identifier — may return no hits or mismatched results
- MyGene.info upstream service unavailable — endpoint returns error or timeout
- Query string too ambiguous — returns many low-confidence hits requiring downstream filtering
- Invalid size parameter — may return default result count or an error

## How this service works

Resolves a gene symbol or query to normalized annotation from mygene.info/v3/query: Entrez gene ID, official name, symbol and taxonomy id across species. Autonomous agents and agent-to-agent (A2A) bioinformatics, variant-interpretation and knowledge-graph pipelines use it to canonicalize gene identifiers. Ranking surface: gene symbol to scored annotation hits. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns a JSON object with an 'ok' flag, a niche identifier, and a 'result' array of scored gene annotation hits. Each hit includes the official gene name, NCBI taxonomy ID, gene symbol, and Entrez gene ID. Provenance metadata (source URL and data source name) is also returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "q"
  },
  "size": {
   "type": "integer",
   "description": "size"
  },
  "species": {
   "type": "string",
   "description": "species"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "mygene-gene-annotation",
  "result": {
   "results": [
    {
     "name": "BRCA1 DNA repair associated",
     "taxid": 9606,
     "symbol": "BRCA1",
     "entrezgene": "672"
    }
   ]
  },
  "provenance": {
   "url": "https://mygene.info/v3/query",
   "source": "MyGene.info Gene Annotation Lookup"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-mygene-info-gene-annotation-lookup-b73de9b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mygene-gene-annotation.hergertsynthora.com](https://www.zero.xyz/host/mygene-gene-annotation.hergertsynthora.com/llms.txt)