mcpField
N
Northbeam MCP Server

Northbeam MCP Server

Local
github.com/mattcoatsworthData & Analytics2Updated 82w ago
Repository

About Northbeam MCP Server

Northbeam MCP Server provides access to Northbeam marketing analytics, including metrics, channel performance, cohorts, and attribution. It is for users querying Northbeam data through MCP clients.

Key features

  1. 01Query metric data
  2. 02List metrics and dimensions
  3. 03Retrieve channel performance
  4. 04Analyze cohorts and attribution

Use cases

  1. 01Inspect marketing metrics and dimensions
  2. 02Compare channel performance
  3. 03Review cohort analysis and attribution

MCP support

It exposes tools for querying metrics, dimensions, channel performance, cohort analysis, and attribution, plus a metric resource for MCP clients.

#northbeam#mcp-server#marketing-analytics

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "Northbeam-MCP-Server": {
      "command": "npx",
      "args": [
        "-y",
        "northbeam-mcp"
      ],
      "env": {
        "NORTHBEAM_API_KEY": "<NORTHBEAM_API_KEY>",
        "NORTHBEAM_BRAND": "<NORTHBEAM_BRAND>"
      }
    }
  }
}
Run commandnpx -y northbeam-mcp
Environment variables to set
NORTHBEAM_API_KEYSecret
NORTHBEAM_BRAND

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmnorthbeam-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Northbeam MCP Server

This is a Model Context Protocol (MCP) server for accessing Northbeam marketing analytics data. It provides tools and resources for querying metrics, dimensions, channel performance, cohort analysis, and attribution data from Northbeam.

## Setup

1. Install dependencies:
   ```
   npm install
   ```

2. Create a `.env` file with your Northbeam API key and brand name:
   ```
   NORTHBEAM_API_KEY=your_api_key_here
   NORTHBEAM_BRAND=your_brand_name_here
   ```

3. Run the server:
   ```
   npm run dev
   ```

## Testing with MCP Inspector

You can test the server using the MCP Inspector:

```
npm run inspect
```

This will open a web interface where you can test all the available tools and resources.

## Available Tools

- `get_metric`: Get metric data from Northbeam
- `list_metrics`: List all available metrics in Northbeam
- `list_dimensions`: List all available dimensions in Northbeam
- `get_channel_performance`: Get channel performance data from Northbeam
- `get_cohort_analysis`: Get cohort analysis data from Northbeam
- `get_attribution`: Get attribution data from Northbeam

## Available Resources

- `northbeam://metrics/{metric_name}`: Get data for a specific metric

## Usage as a Package

You can also use this as an npm package:

```
npx northbeam-mcp
```

Or with the inspector:

```
npx @modelcontextprotocol/inspector npx northbeam-mcp
```

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.