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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gi_mcp-0.1.0a13.tar.gz (76.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gi_mcp-0.1.0a13-py3-none-any.whl (74.3 kB view details)

Uploaded Python 3

File details

Details for the file gi_mcp-0.1.0a13.tar.gz.

File metadata

  • Download URL: gi_mcp-0.1.0a13.tar.gz
  • Upload date:
  • Size: 76.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gi_mcp-0.1.0a13.tar.gz
Algorithm Hash digest
SHA256 9cc326e2395cb81ef11183b22eb58760c0313f7d0dca354fd243da4209066282
MD5 5ec5043ad2afbccbcfdcd31f1029760a
BLAKE2b-256 ba3558cd044e3d097e25904dbc6eadebaf1ffaaa00c2a195d99bd46e124d253b

See more details on using hashes here.

File details

Details for the file gi_mcp-0.1.0a13-py3-none-any.whl.

File metadata

  • Download URL: gi_mcp-0.1.0a13-py3-none-any.whl
  • Upload date:
  • Size: 74.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gi_mcp-0.1.0a13-py3-none-any.whl
Algorithm Hash digest
SHA256 9783017ef80f05840aac33ca7c191eacf119cadee63f592e7f85ca6278d57ea8
MD5 c3fe3efc0e79760e5b24363b6651692a
BLAKE2b-256 9f953d7759e7ebb7b5343cecb133bac6bdf2c4257e50f15d53cba3be31af5ee6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page