senja-mcp

# 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.* [](https://github.com/andrewconnell/senja-mcp) [](https://www.npmjs.com/package/@andrewconnell/senja-mcp) [](https://www.npmjs.com/package/@andrewconnell/senja-mcp) An MCP (Model Context Protocol) server for the [Senja](https://senja.io) 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: ```console git clone https://github.com/andrewconnell/senja-mcp.git cd senja-mcp ``` 2. Install dependencies: ```console npm install ``` 3. Build the project: ```console npm run build ``` ## Configuration ### Claude Desktop Add the following to your Claude Desktop configuration file (`claude_desktop_config.json`): ```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: ```json { "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