Docs

Docs MCP Server

Connect AI assistants to your Rasepi documentation platform over the Model Context Protocol. The rasepi-mcp-docs server exposes 69 tools across hubs, entries, translations, expiry, templates, analytics, and access control.

Overview

The Docs MCP server gives an assistant full access to your documentation: create and edit hubs and entries, manage translations, track expiry and reviews, apply templates, read analytics, and control access. Every response is freshness-aware and tenant-scoped.

69 Tools

Hubs, entries, translations, expiry, reviews, templates, analytics, and access control.

Freshness-Aware

Every response includes expiry status, so the assistant knows when content is stale.

Tenant-Scoped

All operations are automatically scoped to your tenant. No cross-tenant leakage.

stdio Transport

Standard stdio transport works with Claude Desktop, VS Code, and any MCP client.

Install

cd developers/mcp
npm install
npm run build

For development without building, run the Docs server directly:

npm run dev:docs

Authentication

The server authenticates with a Bearer token passed via environment variables:

RASEPI_API_URL=http://localhost:5000
RASEPI_API_TOKEN=dev-token-{tenantId}:{userId}

Dev tokens use the format dev-token-{'{'}tenantId{'}'}:{'{'}userId{'}'}. In production, use a JWT from the OAuth flow.

Claude Desktop Configuration

Add the Docs server to claude_desktop_config.json, pointing at bin/docs.js:

{
  "mcpServers": {
    "rasepi-docs": {
      "command": "node",
      "args": ["path/to/developers/mcp/dist/bin/docs.js"],
      "env": {
        "RASEPI_API_URL": "http://localhost:5000",
        "RASEPI_API_TOKEN": "dev-token-tenant:user"
      }
    }
  }
}

Hubs Tools (7)

list_hubs

List all accessible hubs in the tenant

get_hub

Get a hub by ID with full details

create_hub

Create a new hub

update_hub

Update hub name, description, settings

delete_hub

Delete a hub (owner only)

get_root_entry

Get the root/landing entry for a hub

transfer_hub_ownership

Transfer hub ownership to another user

Entries Tools (12)

list_entries

List entries in a hub with pagination

get_entry

Get full entry with content blocks

create_entry

Create a new entry with TipTap content

update_entry

Update entry content (triggers stale detection)

delete_entry

Delete or soft-delete an entry

publish_entry

Change entry status to Published

search_entries

Full-text search within a hub

get_entry_blocks

Get individual content blocks

update_entry_block

Update a single block

get_entry_versions

List version history

restore_entry_version

Restore a previous version

duplicate_entry

Clone an entry within the same hub

Translations Tools (7)

list_translations

List all translations for an entry

get_translation

Get translation in a specific language

create_translation

Start a new translation

get_translation_blocks

Get block-level translation status

update_translation_block

Update a translated block

mark_translation_up_to_date

Mark translation as current

get_translation_status

Summary of stale/current blocks

Expiry & Reviews Tools (20)

get_expiry_status

Check entry expiry status

update_expiry

Set/change expiry date

renew_entry

Renew an entry after review

list_reviews

List reviews for an entry

submit_review

Submit a content review

get_expiry_dashboard

Tenant-wide expiry overview

Showing 6 of 20 — see full reference for the rest.

Templates Tools (10)

list_templates

Browse available templates

get_template

Get template details and blocks

create_template

Create a new template

update_template

Update template content

delete_template

Delete a template

apply_template

Apply template to an entry

rate_template

Rate a template (1-5 stars)

list_template_categories

Get template categories

export_template

Export as JSON

import_template

Import from JSON

Analytics Tools (4)

get_entry_analytics

Views, edits, time spent on entry

get_entry_events

Activity timeline for entry

get_hub_analytics

Hub-level analytics summary

list_inactive_entries

Find entries with no recent activity

Access Tools (9)

list_hub_memberships

List members and roles for a hub

add_hub_member

Add a user to a hub with a role

remove_hub_member

Remove a user from a hub

get_entry_permissions

Read the permission set for an entry

set_entry_permission

Grant or revoke a permission on an entry

Showing 5 of 9 — see full reference for the rest.