Skip to content
Masthead Data

Masthead MCP Server

Use MCP to integrate Masthead with your favorite AI coding tools and services.

The Masthead MCP server provides access to pipeline monitoring, incident management, and table lineage data. See the tool definitions for the full list of available commands.

Client setup

Section titled “Client setup”

Interactive clients automatically handle Google SSO authentication in the browser and cache the token. Headless environments, such as CI/CD or server agents, should use a service account token.

  • Server URL: https://mcp.mastheadata.com/mcp
  • Transport: Streamable HTTP using POST /mcp
  • Auth: Bearer JWT issued by https://sso.mastheadata.com. To learn how to generate and exchange tokens, see the Authentication and tokens guide.
Claude Code CLI

Run the following command to add the server:

Terminal window
claude mcp add --transport http masthead https://mcp.mastheadata.com/mcp

Note that Claude Code automatically manages the Google SSO flow in the browser and caches the token.

Codex

Create or edit .codex/config.toml in your project root:

[mcp_servers.masthead]
url = "https://mcp.mastheadata.com/mcp"

To log in and authenticate:

Terminal window
codex mcp login masthead
VS Code

Create or edit .vscode/mcp.json in your workspace root for compatible VS Code extensions. This applies to extensions such as GitHub Copilot and customized workspace agents:

{
  "servers": {
    "masthead": {
      "type": "http",
      "url": "https://mcp.mastheadata.com/mcp"
    }
  }
}
Google Antigravity

Antigravity supports stdio transport only. Use mcp-remote as the bridge.

Open Agent panel → MCP Servers → Manage MCP Servers → edit mcp_config.json:

{
  "mcpServers": {
    "masthead": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mastheadata.com/mcp"
      ]
    }
  }
}

Reload MCP servers or restart the IDE. A browser tab opens for Google SSO on first launch.

AI agent skills

Section titled “AI agent skills”

To help your AI assistant automate complex tasks with the Masthead MCP server, you can configure pre-built agent skills. For the list of available skills and setup instructions, see the AI agent skills guide.