Skip to main content
Pre-release

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)

Source distribution for gi-mcp 0.1.0a17
File Size Uploaded
gi_mcp-0.1.0a17.tar.gz 90.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for gi-mcp 0.1.0a17
File Interpreter ABI Platform
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
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page