Northbeam MCP Server

What is Northbeam MCP Server?

Northbeam MCP Server is a Model Context Protocol (MCP) server that provides tools and resources for querying metrics, dimensions, channel performance, cohort analysis, and attribution data from Northbeam marketing analytics. It is designed for developers and analysts who want to integrate Northbeam data into AI‑powered workflows.

How to use Northbeam MCP Server?

Install dependencies with npm install, create a .env file containing NORTHBEAM_API_KEY and NORTHBEAM_BRAND, then run the server with npm run dev. You can also use it as an npm package via npx northbeam-mcp.

Key features of Northbeam MCP Server

• Query metric data from Northbeam
• List all available metrics and dimensions
• Get channel performance data
• Perform cohort analysis
• Retrieve attribution data
• Access metric data via a URI resource

Use cases of Northbeam MCP Server

• Retrieve a specific marketing metric for a dashboard
• Analyze channel performance across campaigns
• Run cohort analysis to understand customer behavior
• Obtain attribution data for marketing ROI calculations
• List available dimensions to explore data structure

FAQ from Northbeam MCP Server

What is the Northbeam MCP Server?

It is an MCP server that allows you to interact with Northbeam marketing analytics data using tools and resources.

What are the prerequisites to use this server?

You need Node.js, npm, a Northbeam API key, and your Northbeam brand name.

How do I set up the server?

Install dependencies (npm install), create a .env file with NORTHBEAM_API_KEY and NORTHBEAM_BRAND, then run npm run dev.

What tools are available?

The server provides six tools: get_metric, list_metrics, list_dimensions, get_channel_performance, get_cohort_analysis, and get_attribution.

How can I test the server?

You can test it using the MCP Inspector by running npm run inspect, which opens a web interface for testing all tools and resources.