K-Dense-AI/scientific-agent-skills / skills/database-lookup
database-lookup
VerifiedQueries documented public database APIs with explicit endpoints, filters, pagination, and provenance. Used when a scientific, regulatory, financial, or other database-backed fact must be retrieved reproducibly from a named source rather than inferred from general knowledge.
references/omim.md
View on GitHub# OMIM (Online Mendelian Inheritance in Man) API Reference
## Base URL
```
https://api.omim.org/api
```
## Authentication
**API key REQUIRED.** Request at https://omim.org/api (free for academic/non-commercial use).
- Pass as query parameter: `?apiKey=YOUR_API_KEY`
- All requests require the key; unauthenticated requests are rejected.
## Rate Limits
Not publicly documented in detail. Reasonable usage expected per terms of service.
## Response Format
JSON (with `&format=json`) or XML (default). Always append `&format=json` for JSON responses.
## Key Endpoints
### 1. Entry Lookup (by MIM number)
```
GET https://api.omim.org/api/entry?mimNumber={mim_number}&apiKey={key}&format=json
```
Example:
```
GET https://api.omim.org/api/entry?mimNumber=141900&apiKey=YOUR_KEY&format=json
```
Returns entry metadata; request text, gene maps, allelic variants and references with the corresponding `include` options.
### 2. Entry with Specific Includes
```
GET https://api.omim.org/api/entry?mimNumber=141900&include=text&include=allelicVariantList&include=geneMap&apiKey={key}&format=json
```
Include options: `text`, `clinicalSynopsis`, `geneMap`, `allelicVariantList`, `referenceList`, `existFlags`, `externalLinks`.
### 3. Search Entries
```
GET https://api.omim.org/api/entry/search?search={query}&apiKey={key}&format=json
```
Example — search for "Marfan syndrome":
```
GET https://api.omim.org/api/entry/search?search=marfan+syndrome&apiKey=YOUR_KEY&format=json&start=0&limit=10
```
### 4. Search filters
`/entry/search` accepts a `filter` search expression, `fields`, `operator=AND|OR`, and `sort`. `filter` is not an enum of `gene`, `phenotype`, and `clinical_synopsis`. Use fielded OMIM search syntax from [OMIM search help](https://omim.org/help/search), or construct the query with the [official API form](https://api.omim.org/api/html/index.html). Do not invent unsupported filter values.
### 5. Gene Map Lookup
```
GET https://api.omim.org/api/geneMap?chromosome={chrom}&apiKey={key}&format=json
```
Example:
```
GET https://api.omim.org/api/geneMap?chromosome=17&apiKey=YOUR_KEY&format=json&start=0&limit=10
```
### 6. Gene Map Search
```
GET https://api.omim.org/api/geneMap/search?search={query}&apiKey={key}&format=json
```
### 7. Clinical Synopsis Search
```
GET https://api.omim.org/api/clinicalSynopsis/search?search={query}&apiKey={key}&format=json
```
## Response Structure (illustrative; fields depend on requested includes)
```json
{
"omim": {
"version": "1.0",
"entryList": [
{
"entry": {
"mimNumber": 141900,
"status": "live",
"titles": {
"preferredTitle": "HEMOGLOBIN--BETA LOCUS; HBB"
},
"textSectionList": [...],
"geneMap": {
"chromosome": "11",
"cytoLocation": "11p15.4",
"geneSymbols": "HBB"
}
}
}
]
}
}
```
## Pagination
Use `start` and `limit` query parameters:
```
&start=0&limit=20
```
## MIM Number Types
- **Asterisk (*)**: Gene
- **Plus (+)**: Gene with known phenotype
- **Number sign (#)**: Phenotype (molecular basis known)
- **Percent (%)**: Phenotype (molecular basis unknown)
- **Null**: Other entry types
## Notes
- OMIM data is copyrighted; API access is free for academic use but requires registration.
- The API does not support bulk downloads; use OMIM downloads page with separate agreement.
- Cross-reference MIM numbers with ClinVar, NCBI Gene, and HPO for integrated disease analysis.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |