Scrive Mcp

scrive-mcp

A Model Context Protocol server in TypeScript that integrates with Scrive for document automation.

> New here? Follow the Getting Started guide for a quick walkthrough. Full user-facing documentation lives at scrive.github.io/mcp. This README covers building and developing the server.

Prerequisites

• Node.js 24+
• Corepack enabled
• pnpm 10+
• Docker (optional)

Setup

1. Enable Corepack and install dependencies

corepack enable
pnpm install

2. Build the server and MCP App UI

pnpm run build

3. Configure credentials for stdio mode

Run the OAuth authorization flow:

node dist/index.js auth

This prompts for your Scrive server and OAuth client credentials (from your Scrive Integration settings), then opens your browser to authorize the application.

Running

Stdio transport

For local MCP clients:

node dist/index.js stdio ~/Documents ~/Downloads

Arguments after stdio are directories the server is allowed to read PDFs from. Tools that take a local path (such as create_document) reject paths outside this list. ~ is expanded.

HTTP transport

For remote deployments with bearer-token forwarding:

export PORT=8080
export AUTH_SERVER_URL=https://oauth2.scrive.com
export SCRIVE_BASE_URL=https://scrive.com
export RESOURCE_URL=https://your-host.example.com/mcp
export SCOPES=full
export ALLOWED_CORS_ORIGINS=https://claude.ai,https://chatgpt.com

node dist/index.js http

Set ALLOWED_CORS_ORIGINS to the exact web client origins that should be allowed to call /mcp. Wildcards such as * are not supported by the current HTTP transport.

The HTTP server exposes:

• /.well-known/oauth-protected-resource
• /mcp

DNS rebinding protection is enabled by default from the configured RESOURCE_URL hostname and can be disabled with:

export DISABLE_DNS_REBINDING_PROTECTION=true

Available MCP Tools

| Tool | Description | | -------------------------- | ---------------------------------------------------------- | | create_document | Upload a PDF file from an absolute local path. | | list_documents | List documents with filtering and sorting options. | | get_document | Retrieve a document's full JSON representation. | | add_party | Add a signing party to an existing document. | | start_signing | Start the signing flow for a document. | | remind_document | Send reminders to signatories who have not signed yet. | | get_usage_stats | Retrieve daily or monthly Scrive usage statistics. | | create_flow_draft | Create a new Journey flow draft. | | add_document_to_draft | Add a PDF document to an existing Journey draft. | | list_flow_drafts | List Journey flow drafts. | | get_flow_draft | Retrieve a Journey flow draft. | | delete_flow_draft | Delete a Journey flow draft. | | start_flow | Start a Journey flow draft. | | add_participant_to_draft | Add a participant to a Journey draft and regenerate steps. |

Testing

pnpm test
pnpm run build

Docker

Build

docker build -t scrive-mcp .

Run

docker run -p 8080:8080 \
  -e PORT=8080 \
  -e AUTH_SERVER_URL=https://oauth2.scrive.com \
  -e SCRIVE_BASE_URL=https://scrive.com \
  -e RESOURCE_URL=https://your-host.example.com/mcp \
  -e SCOPES=full \
  -e ALLOWED_CORS_ORIGINS=https://claude.ai,https://chatgpt.com \
  scrive-mcp

Security

Scrive takes security seriously. If you believe you have found a security issue in scrive-mcp, please report it privately to security@scrive.com rather than opening a public issue or pull request.

When reporting, please include:

• A description of the issue and its potential impact.
• Steps to reproduce, along with any proof-of-concept code, logs, or screenshots.
• The affected version or commit, and any relevant configuration.

We will acknowledge your report, investigate, and keep you informed as we work on a fix. Please give us reasonable time to address the issue before any public disclosure.

Project Structure

src/commands/    CLI commands (auth, stdio, http)
src/scrive/      Scrive API clients
src/tools/       MCP tool implementations
src/server.ts    MCP server setup and tool/resource registration
tests/           Vitest coverage for config and tool behavior
src/ui/          Vite-based MCP App example (file-upload UI for remote mode)

Previewing the docs

The docs site lives under docs/ and is built with Hugo using the hugo-book theme. CI builds and deploys it to GitHub Pages on every push to main.

To preview docs locally, install Hugo and run the script:

brew install hugo                # macOS — use scoop / winget / apt as appropriate
./scripts/preview-docs.sh

The script fetches the theme on first run, stages README.md and LICENSE into the site, and starts Hugo's dev server at with live reload. All generated files (theme, staged content, build output) are gitignored.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: scrive
• Source: scrive/mcp
• License: MIT

Install and usage instructions live in the source repository linked above.