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:

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

gi_mcp-0.1.0a12.tar.gz (76.5 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.0a12-py3-none-any.whl (73.7 kB view details)

Uploaded Python 3

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

Hashes for gi_mcp-0.1.0a12.tar.gz
Algorithm Hash digest
SHA256 c96421d1525d9467adc51798c13e4f0140a4872b5c3179f71c06b7b4cea07c44
MD5 a3491cc1ed1141e63d4fbfb464ef3816
BLAKE2b-256 b46ff2c91b178f79a3173105158f2fba72819d499c2c0d3e69606b58eca6213e

See more details on using hashes here.

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

Hashes for gi_mcp-0.1.0a12-py3-none-any.whl
Algorithm Hash digest
SHA256 f1167e09603e3dd61cbc40c52be2d4384bff7c84c1a3518c6badd54d13d5877c
MD5 536a758bf94278eb401670d395e9c75c
BLAKE2b-256 669d9a43f74e6c247c2ab8b4a3e5c7374cfd2d776377df46a26f263839e3b419

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