npm package: @helprism/mcp
Description: MCP server for managing Helprism help centers via AI tools
Latest version: 1.0.1

# @helprism/mcp

MCP (Model Context Protocol) server for managing [Helprism](https://helprism.com) help centers from AI-powered editors like Claude Code, Cursor, and Windsurf.

Create articles, organize categories, and update workspace settings — all through natural language in your editor.

> **Requires a Helprism Business plan** and an API key. Generate your key in [Settings > API](https://helprism.com/dashboard/settings).

## Quick Start

### Claude Code

One command:

```bash
claude mcp add helprism --env HELPRISM_API_KEY=hp_your_api_key_here -- npx -y @helprism/mcp
```

Or add to `.mcp.json` in your project root:

```json
{
  "mcpServers": {
    "helprism": {
      "command": "npx",
      "args": ["-y", "@helprism/mcp"],
      "env": {
        "HELPRISM_API_KEY": "hp_your_api_key_here"
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "helprism": {
      "command": "npx",
      "args": ["-y", "@helprism/mcp"],
      "env": {
        "HELPRISM_API_KEY": "hp_your_api_key_here"
      }
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "helprism": {
      "command": "npx",
      "args": ["-y", "@helprism/mcp"],
      "env": {
        "HELPRISM_API_KEY": "hp_your_api_key_here"
      }
    }
  }
}
```

Replace `hp_your_api_key_here` with your actual API key.

## Tools

### Articles

| Tool | Description |
|---|---|
| `list_articles` | List all articles, optionally filtered by status (`draft`, `in_review`, `published`) |
| `get_article` | Get a single article with full content as markdown |
| `create_article` | Create a new article from markdown content |
| `update_article` | Update title, content, status, or category |
| `delete_article` | Permanently delete an article (requires `confirm: true`) |

### Categories

| Tool | Description |
|---|---|
| `list_categories` | List all categories |
| `get_category` | Get a single category by ID |
| `create_category` | Create a new category with name, description, and icon |
| `update_category` | Update name, description, or icon |
| `delete_category` | Permanently delete a category (requires `confirm: true`) |

### Workspace

| Tool | Description |
|---|---|
| `get_workspace` | Get current workspace settings |
| `update_workspace` | Update name, branding, SEO, hero text, and dark mode settings |

## Prompts

Two built-in prompts guide your AI through common workflows:

- **`generate-knowledge`** — Turn source material (feature specs, changelogs, support tickets) into a well-structured draft article.
- **`update-knowledge`** — Revise an existing article when something changes.

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `HELPRISM_API_KEY` | Yes | Your API key (starts with `hp_`) |
| `HELPRISM_API_URL` | No | Override the API base URL (defaults to `https://api.helprism.com`) |

## Rate Limits

The API allows 100 requests per minute per API key. The MCP server surfaces rate limit errors automatically.

## Links

- [Helprism](https://helprism.com)
- [API Documentation](https://help.helprism.com/api-docs)
- [Dashboard](https://helprism.com/dashboard)

## License

MIT