### Run the setup wizard with npx
Source: https://www.simplecommenter.com/docs/integrations/ai-agent
Initializes the Simple Commenter MCP server from your project's root directory. This command starts the interactive setup wizard.
```bash
npx @simple-commenter/mcp-server init
```
--------------------------------
### Install globally and run init
Source: https://www.simplecommenter.com/docs/integrations/ai-agent
Alternative to npx: installs the MCP server globally, then runs the init command. Useful if you prefer a global installation.
```bash
npm install -g @simple-commenter/mcp-server
simple-commenter-mcp init
```
--------------------------------
### Start an export task with start_task
Source: https://www.simplecommenter.com/docs/integrations/ai-agent
Use start_task to begin a long-running export or report, such as a CSV of website and asset feedback. The example shows the required arguments including project_id, source, include_archived, and an idempotency_key. Save the returned task_id and poll with get_task.
```json
{
"operation": "export_comments",
"arguments": {
"project_id": "PROJECT_ID",
"source": "all",
"include_archived": true
},
"idempotency_key": "feedback-export-2026-09-06"
}
```
--------------------------------
### Verify setup with doctor command
Source: https://www.simplecommenter.com/docs/integrations/ai-agent
Checks Node.js version, config file and permissions, token, API connectivity, default project, and .mcp.json, reporting pass/fail for each. If not installed globally, use npx @simple-commenter/mcp-server doctor instead.
```bash
simple-commenter-mcp doctor
```
--------------------------------
### SimpleCommenter("boot", { user, userHash })
Source: https://www.simplecommenter.com/docs/js-api/reference
Starts the widget and identifies the user in one call. This is the main entry point and is idempotent.
```APIDOC
## SimpleCommenter("boot", { user, userHash })
### Description
Starts the widget and identifies the user in one call. This is the main entry point, and it is idempotent: booting with the same user twice does nothing. On a login-protected project, boot is also what makes the widget appear at all.
### Method
SimpleCommenter command
### Parameters
- **user** (object) - Required - User identification object containing email, name, and optional externalId.
- **email** (string) - Required - User's email address.
- **name** (string) - Required - User's display name.
- **externalId** (string) - Optional - Your stable user ID.
- **userHash** (string) - Required - Hash for user verification (unless unverified mode is on).
### Request Example
```javascript
SimpleCommenter("boot", { user: { email, name, externalId }, userHash });
```
### Response
No response value is returned.
```
--------------------------------
### window.simpleCommenterSettings object
Source: https://www.simplecommenter.com/docs/js-api/reference
Read once when the widget starts. Setting it before the script tag is equivalent to calling boot with the same values. userHash is required unless unverified mode is on.
```javascript
window.simpleCommenterSettings = {
user: {
email: "jane@acme.com", // required for identification
name: "Jane Cooper", // shown on comments
externalId: "usr_123", // optional, your stable user id
},
userHash: "...", // required unless unverified mode is on
};
```
--------------------------------
### HTML Integration Example
Source: https://www.simplecommenter.com/docs/installation
Recommended placement of the script tag before the closing body tag of your HTML document.
```html
My Website
```
--------------------------------
### List clients on a project
Source: https://www.simplecommenter.com/docs/rest-api/members-and-clients
Sends a GET request to the /api/external/clients endpoint with the X-Integration-Token header and a domainId query parameter to list clients for a project.
```bash
curl -H "X-Integration-Token: $TOKEN" \
"https://www.simplecommenter.com/api/external/clients?domainId=sc_xxx"
```
--------------------------------
### Success Response
Source: https://www.simplecommenter.com/docs/integrations/webhooks
Example of a successful response for an integration action.
```json
{
"success": true,
"message": "Integration action completed successfully",
"result": {
"_id": "507f1f77bcf86cd799439011",
"oldStatus": "todo",
"newStatus": "done"
}
}
```
--------------------------------
### SimpleCommenter boot command
Source: https://www.simplecommenter.com/docs/js-api/reference
Starts the widget and identifies the user in one call. Idempotent: booting with the same user twice does nothing. On login-protected projects, boot is required for the widget to appear.
```javascript
SimpleCommenter("boot", { user: { email, name, externalId }, userHash });
```
--------------------------------
### Manual .mcp.json configuration for Simple Commenter
Source: https://www.simplecommenter.com/docs/integrations/ai-agent
Merge this entry into your client's MCP configuration for a manual, portable setup. The wizard writes a node command, but this uses npx to run the server.
```json
{
"mcpServers": {
"simple-commenter": {
"command": "npx",
"args": ["-y", "@simple-commenter/mcp-server", "serve"]
}
}
}
```
--------------------------------
### Basic Installation: Add script before closing body tag
Source: https://www.simplecommenter.com/docs/installation/php
Place this HTML before the closing tag. Replace sc_your_project_key with your project's public key from the Simple Commenter dashboard. The script is deferred to avoid blocking page render.
```html