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:
cd mcp-server
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest # full suite (mocked; no network)
Release history is in CHANGELOG.md.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gi_mcp-0.1.0a12.tar.gz.
File metadata
- Download URL: gi_mcp-0.1.0a12.tar.gz
- Upload date:
- Size: 76.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c96421d1525d9467adc51798c13e4f0140a4872b5c3179f71c06b7b4cea07c44
|
|
| MD5 |
a3491cc1ed1141e63d4fbfb464ef3816
|
|
| BLAKE2b-256 |
b46ff2c91b178f79a3173105158f2fba72819d499c2c0d3e69606b58eca6213e
|
File details
Details for the file gi_mcp-0.1.0a12-py3-none-any.whl.
File metadata
- Download URL: gi_mcp-0.1.0a12-py3-none-any.whl
- Upload date:
- Size: 73.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f1167e09603e3dd61cbc40c52be2d4384bff7c84c1a3518c6badd54d13d5877c
|
|
| MD5 |
536a758bf94278eb401670d395e9c75c
|
|
| BLAKE2b-256 |
669d9a43f74e6c247c2ab8b4a3e5c7374cfd2d776377df46a26f263839e3b419
|