Senja

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

@andrewconnell/senja-mcp@next @andrewconnell/senja-mcp@latest @andrewconnell/senja-mcp@next

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