Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • AWS Knowledge Base Retrieval MCP Server
  • SQLite MCP Server
  • mcp-server-data-exploration
  • MCP Sumo Logic Server
  • Chrome Debug MCP Server
Back to MCP Servers
PlainSignal MCP Server

PlainSignal MCP Server

Public
plainsignal/plainsignal-mcp

Model Context Protocol server enabling retrieval of detailed analytics reports and metrics through configurable API endpoints, supporting customizable time periods, filters, and data aggregation for advanced analytics insights.

javascript
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with PlainSignal MCP Server

MCP Server

Unlock the full potential of PlainSignal MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

PlainSignal MCP Server

This is a Model Context Protocol (MCP) server implementation for PlainSignal analytics data. It provides tools for retrieving analytics reports and metrics through the MCP protocol.

Setup

Installation

From npm (recommended)

# Install globally npm install -g @plainsignal/plainsignal-mcp # Or install locally in your project npm install @plainsignal/plainsignal-mcp

From source

  1. Clone this repository
  2. Install dependencies:
npm install

This project uses ES modules instead of CommonJS. Make sure you're using a Node.js version that supports ES modules (Node.js 14+).

Usage

When installed from npm

# If installed globally plainsignal-mcp --token # If installed locally npx plainsignal-mcp --token # Or using an environment variable export PLAINSIGNAL_TOKEN= plainsignal-mcp

When using from source

Run the server with your access token:

node src/index.js --token # Or using an environment variable export PLAINSIGNAL_TOKEN= node src/index.js

You can also specify a custom API base URL:

node src/index.js --token --api-base-url

Or use the short format:

node src/index.js -t -u

Alternatively, set the access token and API base URL as environment variables and use the test script:

export PLAINSIGNAL_TOKEN=your_access_token export API_BASE_URL=https://app.plainsignal.com/api/v1 ./test.sh

By default, the server connects to https://app.plainsignal.com/api/v1.

MCP Server configs

Claude Desktop

Add this snippet to your claude_desktop_config.json:

{
  "mcpServers": {
    "plainsignal": {
      "command": "npx -y @plainsignal/plainsignal-mcp",
      "env": {
        "PLAINSIGNAL_TOKEN": ""
      }
    }
  }
}

Available Tools

The server provides the following tools:

getReport

Retrieves an analytics report for a specified domain and time period.

Parameters:

  • organizationID: Organization ID
  • domainID: Domain ID
  • periodFrom: Report start datetime in RFC3339 format
  • periodTo: Report end datetime in RFC3339 format
  • periodSelection: Period type (m: month, y: year, d: day)
  • aggregationWindow: Data aggregation window (h: hour, d: day)
  • filters: (Optional) List of filters as key-value pairs

getSubReport

Retrieves detailed metrics for a specific aspect of analytics data.

Parameters:

  • organizationID: Organization ID
  • domainID: Domain ID
  • periodFrom: Report start datetime in RFC3339 format
  • periodTo: Report end datetime in RFC3339 format
  • periodSelection: Period type (m: month, y: year, d: day)
  • aggregationWindow: Data aggregation window (h: hour, d: day)
  • subReportType: Type of report (1: page, 2: entry page, etc.)
  • filters: (Optional) List of filters as key-values pairs
  • pagination: (Optional) Pagination controls with limit and offset

API Reference

This server communicates with the PlainSignal API. By default, it connects to https://app.plainsignal.com/api/v1, but you can configure the API endpoint in several ways:

  1. Use the --api-base-url command line option:

    node src/index.js --token --api-base-url https://app.plainsignal.com/api/v1
  2. Set the API_BASE_URL environment variable:

    export API_BASE_URL=https://app.plainsignal.com/api/v1
  3. Pass a custom API base URL to the constructor when instantiating the server programmatically:

    const server = new PlainSignalStdioServer(token, 'https://app.plainsignal.com/api/v1');

For Developers

The server is implemented using the MCP SDK and communicates over STDIO.

Examples

An example client is provided to demonstrate how to use the MCP server:

# Set your access token export PLAINSIGNAL_TOKEN=your_access_token # Run the example client npm run example

Or run the resources example client:

# Set your access token export PLAINSIGNAL_TOKEN=your_access_token # Run the resources example client npm run resources-example

The example client demonstrates:

  1. Connecting to the MCP server
  2. Listing available tools
  3. Calling the getReport tool with sample parameters
  4. Processing and displaying the results

The resources example client demonstrates:

  1. Connecting to the MCP server
  2. Listing available resources
  3. Reading the listDomains resource
  4. Processing and displaying the results

License

This project is licensed under the MIT License - see the LICENSE file for details.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • AWS Knowledge Base Retrieval MCP Server
    AWS Knowledge Base Retrieval MCP Server

    Retrieval-Augmented Generation (RAG) server enabling efficient extraction of contextual information ...

    Added May 30, 2025
  • SQLite MCP Server
    SQLite MCP Server

    A Model Context Protocol server enabling AI models to execute SQL queries, manage SQLite database sc...

    Added May 30, 2025
  • mcp-server-data-exploration
    mcp-server-data-exploration

    Interactive Model Context Protocol server enabling seamless data exploration by loading CSV datasets...

    2 tools
    Added May 30, 2025
  • MCP Sumo Logic Server
    MCP Sumo Logic Server

    Model Context Protocol server integrating with Sumo Logic API to perform customizable log searches w...

    Added May 30, 2025
  • Chrome Debug MCP Server
    Chrome Debug MCP Server

    Model Context Protocol server enabling advanced browser automation with Playwright, featuring multi-...

    13 tools
    Added May 30, 2025