English Français العربية

Mosaic Pre-Clinical Intelligence

Official registry Health

Pre-clinical drug-target intelligence: 60 curated targets, 1,969 counted partner genes, 11 tools

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mosaic-mcp
Claude Code 
claude mcp add mosaic-pre-clinical-intelligence -e 'DATABASE_URL=<your database_url>' -e 'MOSAIC_API_KEY=<your mosaic_api_key>' -e 'MOSAIC_TIER=<MOSAIC_TIER>' -- uvx mosaic-mcp==2.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mosaic-pre-clinical-intelligence": {
            "command": "uvx",
            "args": [
                "mosaic-mcp==2.2.1"
            ],
            "env": {
                "DATABASE_URL": "<your database_url>",
                "MOSAIC_API_KEY": "<your mosaic_api_key>",
                "MOSAIC_TIER": "<MOSAIC_TIER>"
            }
        }
    }
}

Environment variables

  • DATABASE_URL required secret PostgreSQL/Neon connection string for YOUR Mosaic knowledge graph (must end /mosaic_db). Bring your own database — no shared instance is provided.
  • MOSAIC_API_KEY secret API key unlocking the 7 Pro tools (optional; the 5 free tools work without it)
  • MOSAIC_TIER Override tier for local dev: free (default), pro, or enterprise

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mosaic-mcp
  2. Which one do you want?
  3. Quick start (self-hosted)
  4. Tools
  5. Configuration
  6. Changelog
  7. License

mosaic-mcp

Pre-clinical drug-target intelligence as an MCP server: target profiles, compounds, literature, structure, clinical pipeline, validation precedent and whitespace analysis — 11 tools, 5 free and 6 Pro. Every count carries a coverage state, so "we did not look" never renders as zero.

Which one do you want?

This package is bring-your-own-database. It is the MCP tool layer only — it ships the queries, not the data. You point it at a PostgreSQL instance you control, with the Mosaic schema, and it serves the tools over it. There is no public read-only credential for Mosaic's knowledge graph.

If you want Mosaic's curated knowledge graph — 60 oncology targets, ~128K compounds linked to them, 57,896 papers and 9,062 clinical trials (counted 2026-10-07), refreshed monthly — use the hosted server. It needs no database and no local install:

  • Claude.ai connector (OAuth, Streamable HTTP): https://mcp.getmosaic.dev/mcp
  • Remote MCP with an API key (SSE): https://mcp.getmosaic.dev/sse
  • Sign in, API keys and on-demand dossiers for any human gene: https://getmosaic.dev

Quick start (self-hosted)

pip install mosaic-mcp
With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mosaic": {
      "command": "mosaic-mcp",
      "env": {
        "DATABASE_URL": "postgresql://USER:PASSWORD@YOUR-HOST:5432/mosaic_db?sslmode=require"
      }
    }
  }
}
With Claude Code
claude mcp add mosaic -- mosaic-mcp
Standalone
export DATABASE_URL="postgresql://..."   # your own Postgres
mosaic-mcp                               # stdio transport

uvx mosaic-mcp and python -m mosaic_mcp.server work too. This package is stdio-only: --transport sse exits with NotImplementedError, because remote transport is the hosted server above.

Tools

Free (5)
ToolWhat it returns
mosaic_get_target_profileThe target dossier: biology, approved and clinical drugs, disease associations ranked by Open Targets, validation evidence, organisations, scores — each axis with its coverage state
mosaic_get_target_compoundsCompounds with measured activity on the target; sort by potency (default) or by max clinical phase
mosaic_get_target_papersPapers about the target, matched by NCBI Gene ID (PubTator3) where your database has the annotations, up to the declared corpus cutoff
mosaic_get_target_structureAlphaFold structural snapshot and pockets, with a caution when a pocket is lined by low-confidence residues
mosaic_get_coverage_gridA coverage grid for any human gene symbol: identity (HGNC) and structure (AlphaFold DB) resolve live; the other axes are marked queued

Free calls return up to 10 compounds or papers; Pro up to 50.

Pro (6)
ToolWhat it returns
mosaic_clinical_pipelineClinical trials for compounds acting on the target (a ChEMBL mechanism link or pChEMBL ≥ 6)
mosaic_target_validationAssay precedent: what has been tried, in what model system
mosaic_pathway_contextThe pathways the target sits in
mosaic_target_networkThe target's 1-hop neighbourhood: compounds, diseases, pathways, organisations, interacting proteins
mosaic_synthetic_lethal_whitespacePartners functionally coupled to the target with little drug activity — assessed candidates and unassessed partners kept apart
mosaic_resistance_bypass_mapCandidate resistance-bypass and escape targets

mosaic_request_dossier and mosaic_get_dossier (on-demand dossiers) run only on the hosted server; they need its fetch and synthesis pipeline.

Configuration

VariableRequiredDescription
DATABASE_URLYesPostgreSQL connection string for your own instance; the path must name the database that holds the Mosaic schema.
MOSAIC_TIERNopro (or enterprise) enables the Pro tools in a self-hosted install.
MOSAIC_API_KEYNoIn stdio mode any value is treated as Pro; it is not checked locally. Keys are validated by the hosted server.

Changelog

Full history in CHANGELOG.md. Latest: 2.1.1 — the mosaic-mcp command starts again (it had failed with ImportError since 1.7.0). 2.1.0 capped mcp below 2, without which a fresh install died on import, and carried the fixes from a live audit of the hosted server.

License

Apache 2.0 for the MCP server tools. The hosted knowledge graph data requires a subscription for Pro-tier access.

Frequently asked questions

What is Mosaic Pre-Clinical Intelligence?

Pre-clinical drug-target intelligence: 60 curated targets, 1,969 counted partner genes, 11 tools

How do I install Mosaic Pre-Clinical Intelligence?

It runs on your machine. In Claude Code: claude mcp add mosaic-pre-clinical-intelligence -e 'DATABASE_URL=<your database_url>' -e 'MOSAIC_API_KEY=<your mosaic_api_key>' -e 'MOSAIC_TIER=<MOSAIC_TIER>' -- uvx mosaic-mcp==2.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Mosaic Pre-Clinical Intelligence need an API key?

Yes. It expects DATABASE_URL, MOSAIC_API_KEY, which you set in its configuration.

Is Mosaic Pre-Clinical Intelligence open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains Mosaic Pre-Clinical Intelligence?

It is published by sourabhnk. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.