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)

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

Pro (6)

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

Configuration

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.