Skip to content

shadowrock-io/signnow-claude-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SignNow Claude Code Plugin

License: MIT Plugin Version MCP Server SignNow API

A comprehensive Claude Code plugin for building SignNow e-signature API integrations. Provides AI-powered documentation retrieval, multi-language code generation, signing workflow design, multi-tenant architecture guidance, billing/rebilling patterns, SDK maturity advisory, CRM/ERP integration patterns, and security-focused code review — all grounded in live SignNow API documentation via MCP tools.

Author: ShadowRock


What This Plugin Does

This plugin transforms Claude Code into a specialized SignNow integration development environment. It equips the AI assistant with deep knowledge of the SignNow e-signature platform through:

  • 11 slash commands for common developer tasks (project scaffolding, API lookup, auth setup, workflow design, field configuration, embedded signing, branding, diagnostics, and more)
  • 15 auto-activating skills that provide contextual SignNow expertise whenever relevant topics arise in conversation
  • 2 specialized agents (Integration Architect and Code Reviewer) for in-depth architecture design and security-focused code review
  • 5 MCP tools backed by SignNow's documentation service for real-time API reference, code examples, changelog tracking, and OpenAPI spec lookup
  • Automated code linting hooks that enforce SignNow security best practices on every file write

Who This Is For

  • Developers building SignNow API integrations in JavaScript, Python, PHP, C#, Java, or cURL
  • Teams building commercial SaaS products that embed SignNow e-signatures (multi-tenant, billing, white-label)
  • Developers creating CRM/ERP connectors that integrate SignNow with Salesforce, HubSpot, Pipedrive, or custom systems
  • Anyone who wants AI-assisted, documentation-grounded guidance for SignNow's REST API, embedded signing, webhooks, templates, and more

Installation

Via plugin directory

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

Prerequisites

The MCP server (sn-api-helper-mcp) is fetched automatically from PyPI via uvx on first use. No manual server installation required.


Commands

Command Usage Description
/signnow:setup /signnow:setup [language] Generate boilerplate for a new SignNow e-signature integration
/signnow:scaffold /signnow:scaffold [use-case] [language] Use-case-driven project scaffolding (embedded-signing, connector, multi-tenant, kiosk, billing-integration)
/signnow:api /signnow:api [topic] Look up SignNow API endpoint documentation
/signnow:auth /signnow:auth [language] Guide through SignNow OAuth 2.0 setup, generate reusable auth module
/signnow:workflow /signnow:workflow [description] Design a signing workflow with API call sequence
/signnow:fields /signnow:fields [description] Design SignNow field configurations and generate placement code
/signnow:embed /signnow:embed [type] [language] Set up embedded signing, embedded editor, or embedded sending
/signnow:brand /signnow:brand [language] Configure SignNow white-label branding
/signnow:samples /signnow:samples [language or topic] Browse SignNow sample apps, SDKs, and reference implementations
/signnow:changelog /signnow:changelog [since] View SignNow API changelog and recent feature updates
/signnow:diagnose /signnow:diagnose Scan current project for SignNow integration issues and deprecated patterns

Examples

/signnow:setup python
/signnow:scaffold multi-tenant javascript
/signnow:scaffold connector php
/signnow:api upload document
/signnow:auth javascript
/signnow:workflow "NDA with two signers and a CC recipient"
/signnow:fields "contract with signature, date, and initials on each page"
/signnow:embed signing javascript
/signnow:brand php
/signnow:samples java
/signnow:changelog 2025-06-01
/signnow:diagnose

Skills

Skills activate automatically when the conversation touches relevant SignNow topics. No manual invocation needed — Claude detects context and applies the right skill.

Skill Auto-activates when discussing...
signnow-api-guide SignNow API endpoints, REST calls, integration patterns
signnow-code-gen Code generation for SignNow API operations (with SDK maturity gate)
signnow-workflow-design Signing workflows, signer roles, sequential/parallel signing
signnow-auth-setup SignNow OAuth 2.0 authentication, token management, credentials
signnow-webhooks Event-driven integrations, webhook callbacks, event chaining, saga patterns
signnow-fields SignNow document fields — signature, text, checkbox, date, initials, dropdown
signnow-embedded-signing Embedded signing via iframe, kiosk mode, approval workflows, payment requests
signnow-embedded-editor Embedded document editor within host applications
signnow-embedded-sending Embedded invite-sending UI for end-user-driven signature requests
signnow-branding White-label branding, custom logos, colors, email templates
signnow-sample-apps SignNow sample apps, official SDKs, starter projects (with SDK status matrix)
signnow-sdk-advisor SDK maturity assessment, SDK vs direct API decisions, Python SDK stale warning
signnow-multi-tenant Multi-tenant platforms, SignNow Organizations API, tenant isolation, per-tenant branding
signnow-integration-patterns CRM/ERP connectors (Salesforce, HubSpot, Pipedrive), variable mapping, document writeback
signnow-billing-patterns Billing/rebilling architecture, Stripe integration, metered billing, usage tracking

Agents

Agent Purpose
Integration Architect Analyzes requirements and designs end-to-end SignNow signing architectures — including multi-tenant (Organizations API), billing (Stripe), compliance (HIPAA, SOC 2, GDPR), and SDK selection
Code Reviewer Security-focused review of SignNow integration code — checks API correctness, credential handling, webhook validation, tenant isolation, billing idempotency, and SDK version currency

MCP Tools

The plugin is backed by 5 MCP tools that query SignNow's documentation service in real time:

Tool Description
get_signnow_api_info General SignNow API documentation search
search_signnow_api_reference Category-filtered API reference (authentication, documents, invites, templates, webhooks, fields, groups, folders, users, organizations, embedded, branding)
get_signnow_code_example Code examples for SignNow API operations with optional language filtering
get_signnow_changelog SignNow API changelog and release notes with optional date filtering
get_signnow_openapi_spec SignNow OpenAPI specification lookup — endpoint definitions, schemas, parameters

Hooks

Automated hooks enforce SignNow security best practices on every code write:

Hook Event Checks
MCP server check SessionStart Verifies uvx and the MCP server are available
Code linting PostToolUse (Write/Edit) Hardcoded credentials, HTTP URLs, missing error handling, missing rate limit/retry logic, production URL without sandbox support

Architecture

signnow-claude-plugin/              Published by ShadowRock
├── .claude-plugin/plugin.json      Plugin manifest (v0.2.0)
├── .mcp.json                       MCP server binding (auto-fetches via uvx)
├── commands/                       11 user-invocable slash commands
├── skills/                         15 model-invokable context skills
├── agents/                         2 specialized agent personas
├── hooks/                          Session lifecycle + code quality hooks
└── scripts/                        MCP check + lint scripts

sn-api-helper-mcp                   MCP Server (PyPI)
├── get_signnow_api_info            General documentation search
├── search_signnow_api_reference    Category-filtered API reference search
├── get_signnow_code_example        Code example retrieval
├── get_signnow_changelog           Changelog and release notes
└── get_signnow_openapi_spec        OpenAPI specification lookup

The plugin wraps the sn-api-helper-mcp MCP server with Claude Code-specific UX. The MCP server provides the tools; the plugin provides skills, commands, and agents that use those tools.


SignNow SDK Status

Not all SignNow SDKs are equally maintained. The plugin includes an SDK maturity gate that automatically adjusts code generation recommendations:

Language SDK Status Plugin Behavior
PHP signnow/SignNowPHPSDK Active Prefers SDK
Node.js signnow/SignNowNodeSDK Moderate SDK for core ops, direct API for newer features
Java signnow/SignNowJavaAPiClient Moderate SDK for core ops, direct API for newer features
C#/.NET signnow/SignNow.NET Moderate SDK for core ops, direct API for newer features
Python Legacy SDK Stale Always generates direct requests/httpx code

See the signnow-sdk-advisor skill for detailed guidance.


Sample Apps & Resources

Resource Link
Sample App (PHP/Laravel) github.com/signnow/sample-app
PHP SDK github.com/signnow/SignNowPHPSDK
Node.js SDK github.com/signnow/SignNowNodeSDK
Java SDK github.com/signnow/SignNowJavaAPiClient
C# SDK github.com/signnow/SignNow.NET
Postman Collection signnow-api/signnow-public-collection

Supported Languages

Code generation supports: JavaScript/Node.js, Python, C#/.NET, PHP, Java, and cURL.

SignNow API Environments

Environment Base URL
Sandbox https://api-eval.signnow.com
Production https://api.signnow.com

All generated code defaults to the sandbox environment. Switch to production by changing the SIGNNOW_API_BASE_URL environment variable.


Key SignNow Documentation


License

MIT License. See LICENSE.md.

Published by ShadowRock. The MCP server component (sn-api-plugin) is a fork of signnow/sn-api-helper-mcp.

About

SignNow e-signature API developer companion for Claude Code — AI-powered documentation, code generation, workflow design, multi-tenant architecture, billing patterns, and integration guidance. 11 commands, 15 skills, 2 agents, 5 MCP tools.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages