This release is a pre-release and may not be stable for production use.
gi-mcp
For research and development use, not clinical or diagnostic decisions. For high-volume or latency-sensitive use, contact contact@genomicintelligence.ai to provision a production-shaped deployment.
An MCP server for the Genomic Intelligence DNA-analysis API. It exposes the six inference tasks (promoter, splice, enhancer, chromatin, expression, annotation), a composite annotation→expression workflow, sequence acquisition (Ensembl + local FASTA), reference resources, and ready-made prompt workflows — all over MCP stdio.
It runs locally as a thin protocol translator: it owns no inference and stores no key, forwarding each request to your Genomic Intelligence backend under your API key.
Install & configure
gi-mcp runs with uv (uvx fetches and runs it
with no manual install):
uvx gi-mcp # recommended
pip install gi-mcp # alternative
Request a partner key from https://genomicintelligence.ai/contact, then point
your MCP client at uvx gi-mcp with GI_API_KEY in the environment. For
Claude Desktop, edit claude_desktop_config.json and reopen:
{
"mcpServers": {
"genomic-intelligence": {
"command": "uvx",
"args": ["gi-mcp"],
"env": { "GI_API_KEY": "gi_..." }
}
}
}
For Claude Code: claude mcp add genomic-intelligence --env GI_API_KEY=gi_... -- uvx gi-mcp.
📖 Full documentation
https://docs.genomicintelligence.ai/mcp.md — per-client setup, the
handle pattern, copy-paste "try it" prompts, the full tool/resource surface,
and the underlying /v1 contract. Start there.
Environment
| Var | Default | Purpose |
|---|---|---|
GI_API_KEY |
— (required) | Partner bearer key (gi_…) |
GI_BASE_URL |
https://api.genomicintelligence.ai |
Override for staging / local backend |
GI_ENSEMBL_URL |
https://rest.ensembl.org |
Ensembl REST base |
GI_FASTA_ALLOW_ANY |
unset | 1 to skip MCP-roots gating for local FASTA |
GI_ASYNC_TIMEOUT |
240 |
Ceiling (s) a wait=True slow task blocks while streaming progress before returning a timeout error |
GI_ASYNC_POLL_INTERVAL |
2 |
Poll cadence (s) for the block-and-stream loop |
GI_HTTP_TIMEOUT |
300 |
Per-request read timeout (s) for /v1 calls |
Development & contributing
Setup, conventions, the architecture walkthrough, and the release process live
in CONTRIBUTING.md. Quick start:
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest # full suite (mocked; no network)
Release history is in CHANGELOG.md.
Release files for gi-mcp 0.1.0a17
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gi_mcp-0.1.0a17.tar.gz | 90.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gi_mcp-0.1.0a17-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 174.0 kB
Release files / gi_mcp-0.1.0a17.tar.gz
| Download URL | gi_mcp-0.1.0a17.tar.gz |
|---|---|
| Size | 90.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
83d5bbb6a5030d434b4b91f0b46ce9a2e055b2f33feba06ed5eac4e2d987d088
|
|
BLAKE2b-256 checksum How to use checksums |
11d1be90a031c46ddf5376af3c5fab9dfa11ae08279edd2da176f5b3ab55a51b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / gi_mcp-0.1.0a17-py3-none-any.whl
| Download URL | gi_mcp-0.1.0a17-py3-none-any.whl |
|---|---|
| Size | 83.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
57260f89ba2306d18ddf469aa90616944796c513c89e502969ab738247303c27
|
|
BLAKE2b-256 checksum How to use checksums |
dfa9da9797f2ee64664a6b04287ac4a3e208a034be09aa084c4f4070f5cd7495
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|