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.0a14.tar.gz (79.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.0a14-py3-none-any.whl (75.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gi_mcp-0.1.0a14.tar.gz
  • Upload date:
  • Size: 79.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.0a14.tar.gz
Algorithm Hash digest
SHA256 1dd223cb7545411dde9e87051a5205ca4d34dfe1af509fd99729c3a161085c78
MD5 3a72dca267ce95c9a11d46dc65817aee
BLAKE2b-256 5b22cfed637f1a3b4a19049e3413ee7f88f24d5a547cfc42a7f95489f30dd1aa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: gi_mcp-0.1.0a14-py3-none-any.whl
  • Upload date:
  • Size: 75.7 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.0a14-py3-none-any.whl
Algorithm Hash digest
SHA256 8f02a810ccfc3fbf39af30fbdb9dd6c6c32756e6c0e9353b49088959ace2f63b
MD5 c030526fcb3738c875f3395fe59b698b
BLAKE2b-256 6073bc60b96129a217043c1dabf7ffce610aecc2016aeb7122ade3628c9d740e

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