GW MCP MCP Server

An MCP (Model Context Protocol) server providing tools to query Gravitational Wave (GW) data from GraceDB and GWOSC.

Local serverstdioPython

What is the GW MCP MCP server?

Connect GW MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. An MCP (Model Context Protocol) server providing tools to query Gravitational Wave (GW) data from GraceDB and GWOSC. The gw mcp mcp server is what makes that connection.

What the server does

MCP (Model Context Protocol) allows AI assistants like Claude to use external tools. This server gives Claude the ability to query gravitational wave databases in real-time, so you can ask questions about GW events in natural language.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • search_gw_events — GraceDB
  • get_event_details — GraceDB
  • get_superevent — GraceDB
  • get_event_files — GraceDB
  • get_event_labels — GraceDB
  • get_event_gps — GWOSC
  • get_catalog_events — GWOSC
  • fetch_strain_data — GWOSC
  • fetch_event_strain — GWOSC
  • Example — The Example tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: SCITOKEN_FILE, X509_USER_CERT, X509_USER_KEY, X509_USER_PROXY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

The server ships on PyPI as langchain-mcp-adapters, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. GW MCP's toolset — search_gw_events, get_event_details, get_superevent and 7 more — is a fair guide to whether it matches your workflow.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch GW MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
search_gw_eventsGraceDB
get_event_detailsGraceDB
get_supereventGraceDB
get_event_filesGraceDB
get_event_labelsGraceDB
get_event_gpsGWOSC
get_catalog_eventsGWOSC
fetch_strain_dataGWOSC
fetch_event_strainGWOSC
ExampleThe Example tool exposed by this server.

How to install the GW MCP MCP server

{
  "mcpServers": {
    "gw-mcp-git": {
      "command": "uvx",
      "args": ["langchain-mcp-adapters"],
      "env": {
        "SCITOKEN_FILE": "your-value",
        "X509_USER_CERT": "your-value",
        "X509_USER_KEY": "your-value",
        "X509_USER_PROXY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
SCITOKEN_FILECredential the server authenticates with.Yes
X509_USER_CERTConfiguration value read at startup.Optional
X509_USER_KEYCredential the server authenticates with.Yes
X509_USER_PROXYConfiguration value read at startup.Optional

Example prompts to try

  • Use GW MCP to search gw events.
  • Use GW MCP to get event details.
  • Use GW MCP to get superevent.

Frequently asked questions

It connects GW MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (search_gw_events, get_event_details, get_superevent, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with GW MCP directly.