@relay-science/mcp

Model Context Protocol server for the Relay scientific platform. Lets MCP-aware clients (Claude Code, Claude Desktop, Cursor, …) read your jobs, models, workspaces, annotations, comments, pipelines, teams, and compute providers through Relay's HTTP API.

64 tools (read + write + streaming + upload + share), 10 resources, both stdio and Streamable HTTP transports. Streaming tools (watch_job, watch_pipeline_run) emit MCP progress notifications. Destructive operations are flagged via MCP destructiveHint annotations.

Install — Claude Code

claude mcp add relay -- npx -y @relay-science/mcp

Then configure the server URL and your token:

export RELAY_API_URL=https://your-relay-server.example.com   # default: http://localhost:8787
export RELAY_API_TOKEN=eyJ...                                # your Supabase JWT

(Both BIOM_API_URL and BIOM_API_TOKEN are still accepted as fallbacks.)

Programmatic use

import { createBiomMcpServer, BiomApiClient } from "@relay-science/mcp";

const client = new BiomApiClient("http://localhost:8787", {
  getToken: async () => process.env.RELAY_API_TOKEN!,
});
const server = createBiomMcpServer(client);
// bind a transport: stdio, Streamable HTTP, etc.

Hosted (Streamable HTTP) mode

The Relay server mounts the same registry at /mcp via Streamable HTTP. Add it from the client side:

claude mcp add --transport http relay https://your-relay-server.example.com/mcp \
  --header "Authorization: Bearer $RELAY_API_TOKEN"

License

Proprietary — © Relay Science.