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

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:

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:

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.

Gemini Enterprise

Unlike the preceding interactive clients, Gemini Enterprise connects as a confidential OAuth client: it needs a Client ID and Client Secret. Masthead provisions these for your tenant; this guide assumes you already have them. Users sign in with their own Google Accounts, and each gets their own tenant-scoped access.

1. Create the data store. Follow the guide to create the custom MCP server data store.

2. Fill in the authentication settings with the values below, pasting the Client ID and Client Secret you received from Masthead:

Field	Value
MCP Server URL	https://mcp.mastheadata.com/mcp
Authorization URL	https://sso.mastheadata.com/oauth2/authorize
Authorization URL Parameters	&access_type=offline&prompt=consent
Token URL	https://sso.mastheadata.com/oauth2/token
Client ID	(from Masthead)
Client Secret	(from Masthead)
Scopes	mcp offline_access
Enable PKCE Support	leave unchecked

3. Authenticate. Click Login. A browser tab opens for authentication. Sign in and approve the access, then click Continue.

4. Finish the connector. Add a description, click Continue, choose a location and connector name, then Create. Wait for the data store status to change from Creating to Active.

5. Enable the tools. Open the data store, then click Actions → Reload custom actions to fetch the Masthead tool list. Select the actions you want and click Enable actions.

6. Use it. Attach the data store to a Gemini Enterprise app or assistant. You can then ask it questions in natural language, and it will call the Masthead tools automatically (for example, “list the projects Masthead monitors” or “show open data incidents”).

---

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.