SignNow API Helper MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with real-time access to SignNow e-signature API documentation, code examples, changelog tracking, and OpenAPI specification lookup. Designed for use with Claude Code, Claude Desktop, Cursor AI, VS Code (Cline), and any MCP-compatible client.

Author: ShadowRock | Originally forked from signnow/sn-api-helper-mcp

mcp-name: io.github.signnow/sn-api-helper-mcp

---

What This Server Does

The SignNow API Helper MCP server gives AI assistants (Claude, GPT, Copilot, or any MCP client) the ability to search and retrieve live SignNow API documentation. This enables AI-assisted development of SignNow e-signature integrations with accurate, up-to-date API knowledge.

Capabilities

• SignNow API Documentation Search — Query the full SignNow API reference by topic or category (authentication, documents, invites, templates, webhooks, fields, groups, folders, users, organizations, embedded, branding)
• SignNow Code Examples — Retrieve code examples for specific API operations in JavaScript, Python, C#, PHP, Java, or cURL
• SignNow Changelog & Release Notes — Track API changes and new features with optional date filtering
• SignNow OpenAPI Specification Lookup — Fetch endpoint definitions, request/response schemas, and parameter details from the official OpenAPI spec
• Authentication Guidance — SignNow OAuth 2.0 token management, credential configuration, and security best practices
• Integration Best Practices — Document signing workflows, embedded signing, webhook implementation, error handling, and rate limiting

Use Cases

• Building SignNow API Integrations — AI-assisted code generation grounded in live documentation
• SignNow Document Signing Workflows — Multi-signer, sequential/parallel, role-based signing
• SignNow Embedded Signing — iframe-based signing sessions, kiosk mode, embedded editor, embedded sending
• SignNow Webhook Implementation — Event-driven architectures, callback endpoints, payload validation
• SignNow Template Management — Template creation, prefilling, bulk send
• SignNow SDK Development — Code examples and patterns for all supported languages
• Staying Current — Changelog tracking to identify new features, deprecated patterns, and API changes

---

Available Tools (5)

Tool	Description	Parameters
get_signnow_api_info	General SignNow API documentation search	query (required), max_results (1-20)
search_signnow_api_reference	Category-filtered SignNow API reference search	query (required), category (optional: authentication, documents, invites, templates, webhooks, fields, groups, folders, users, organizations, embedded, branding), max_results (1-20)
get_signnow_code_example	SignNow code example retrieval	operation (required), language (optional: javascript, python, csharp, php, java, curl)
get_signnow_changelog	SignNow API changelog and release notes	since (optional ISO date), max_results (1-20)
get_signnow_openapi_spec	SignNow OpenAPI spec section lookup	endpoint_path (optional), operation (optional: get, post, put, delete), component (optional schema name)

---

Installation

From PyPI (recommended)

pip install sn-api-helper-mcp

For development

git clone https://github.com/shadowrock-io/sn-api-plugin.git
cd sn-api-plugin
pip install -e ".[test]"

---

Running the Server

Method 1: UVX (recommended for MCP clients)

uvx sn-api-helper-mcp

Method 2: Python module

python -m sn_api_helper_mcp serve

Method 3: CLI entry point

sn-api-helper-mcp serve

---

MCP Client Setup

This server uses stdio transport and works with any MCP-compatible client.

Claude Code (via plugin)

Use the SignNow Claude Code Plugin for the full experience with commands, skills, agents, and hooks:

claude --plugin-dir ./signnow-claude-plugin

Or add the MCP server directly to your project's .mcp.json:

{
  "mcpServers": {
    "signnow-api-helper": {
      "command": "uvx",
      "args": ["sn-api-helper-mcp"]
    }
  }
}

Claude Desktop

1. Open your config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the server configuration:

{
  "mcpServers": {
    "signnow-api-helper": {
      "command": "uvx",
      "args": ["sn-api-helper-mcp"]
    }
  }
}

3. Restart Claude Desktop.

Cursor AI

1. Open Cursor Settings (Cmd/Ctrl + ,).
2. Go to Features > MCP Servers.
3. Click + Add New MCP Server and add:

{
  "mcpServers": {
    "signnow-api-helper": {
      "command": "uvx",
      "args": ["sn-api-helper-mcp"]
    }
  }
}

VS Code (via Cline)

1. Install the Cline extension from the VS Code Marketplace.
2. Open Cline settings -> MCP Servers.
3. Add the configuration:

{
  "signnow-api-helper": {
    "command": "uvx",
    "args": ["sn-api-helper-mcp"]
  }
}

---

SignNow API Reference Categories

The search_signnow_api_reference tool supports filtering by these categories:

Category	Covers
authentication	OAuth 2.0, bearer tokens, token refresh, credential management
documents	Upload, download, create, manage, merge, move documents
invites	Signing invites, freeform invites, role-based invites, embedded invites
templates	Template creation, copying, routing, bulk send
webhooks	Event subscriptions, callbacks, webhook payloads
fields	Signature, text, checkbox, radiobutton, dropdown, date, initials, stamp fields
groups	Team organization, group members
folders	Document organization, folder management
users	Account settings, profile, user management
organizations	Multi-tenant workspaces, org members, roles, tenant isolation
embedded	Embedded signing, embedded editor, embedded sending, iframe integration
branding	White-label branding, custom logos, colors, email templates

---

Development

Running tests

pip install -e ".[test]"
pytest tests/ -v

Project structure

sn-api-plugin/
├── src/sn_api_helper_mcp/
│   ├── server.py              MCP server setup
│   ├── constants.py           Configuration and API URLs
│   ├── response_parser.py     JSON-to-markdown formatting
│   ├── cli.py                 CLI entry point
│   └── tools/
│       ├── get_skills_info.py         General documentation search
│       ├── search_api_reference.py    Category-filtered search
│       ├── get_code_example.py        Code example retrieval
│       ├── get_changelog.py           Changelog tracking
│       └── get_openapi_spec.py        OpenAPI spec lookup
└── tests/
    ├── test_server.py         Server and tool registration tests
    ├── test_tools.py          Tool implementation tests (mocked HTTP)
    └── test_response_parser.py Response formatting tests

---

License

MIT License. See LICENSE.md.

Published by ShadowRock. Originally forked from signnow/sn-api-helper-mcp by airSlate Inc.