MCP Server for Senja (unofficial)

Collect, Manage and Share Testimonials - The easiest way to collect testimonials and add them to your website. Get started for free.

An MCP (Model Context Protocol) server for the Senja testimonial API. This server allows AI assistants like Claude to interact with your Senja testimonials through standardized MCP tools.

Features

• List testimonials with filtering by approval status, rating, type, integration source, tags, and language
• Get a specific testimonial by ID
• Create new testimonials with full support for customer details, ratings, tags, and media

Prerequisites

• Node.js 18+
• A Senja account on the Starter or Pro plan
• A Senja API key (available from the Automate section in your Senja dashboard)

Setup

1. Clone this repository:

   git clone https://github.com/andrewconnell/senja-mcp.git
   cd senja-mcp

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "senja": {
      "command": "node",
      "args": ["/path/to/senja-mcp/lib/index.js"],
      "env": {
        "SENJA_API_KEY": "your-senja-api-key"
      }
    }
  }
}

Claude Code

Add the following to your Claude Code MCP settings:

{
  "mcpServers": {
    "senja": {
      "command": "node",
      "args": ["/path/to/senja-mcp/lib/index.js"],
      "env": {
        "SENJA_API_KEY": "your-senja-api-key"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | | --------------- | -------- | -------------------- | | SENJA_API_KEY | Yes | Your Senja API key |

Available Tools

list_testimonials

Retrieve testimonials with optional filtering and sorting.

Parameters:

• sort — Sort by date or rating (default: date)
• order — Sort direction: asc or desc (default: desc)
• approved — Filter by approval status
• rating — Filter by star rating (1-5)
• type — Filter by type: text or video
• integration — Filter by source (e.g., twitter, google, linkedin)
• tags — Filter by tag names
• lang — Filter by language (ISO 639 code)
• limit — Number of results (1-1000, default: 100)
• page — Page number for pagination

get_testimonial

Retrieve a specific testimonial by ID.

Parameters:

• id — The testimonial ID (required)

create_testimonial

Create a new testimonial.

Parameters:

• type — Testimonial type: text or video (required)
• customer_name — Name of the customer (required)
• title — Testimonial title/headline
• text — Testimonial text content
• rating — Star rating (1-5)
• url — Source URL
• date — Date in ISO 8601 format
• approved — Whether the testimonial is approved
• customer_email — Customer email
• customer_avatar — Customer avatar URL
• customer_company — Customer company name
• customer_tagline — Customer tagline or job title
• customer_website — Customer website URL
• integration — Integration source identifier
• tags — Tags to apply
• video_url — Video URL (for video testimonials)

License

MIT