Signaturit MCP ✍️

Note: This is an unofficial integration project and is not affiliated with, officially maintained, or endorsed by Signaturit.

This project is a demonstration of an MCP (Microservice Communication Protocol) server that integrates with Signaturit tools through their public API. It provides various functionalities for managing signature requests, including listing, creating, and handling signatures.

Capabilities 🚀

The MCP server provides the following tools to interact with Signaturit:

• get_signature 📄: Retrieve details of a specific signature request using its ID
• create_signature ✨: Create new signature requests using templates
  • Support for multiple signers 👥
  • Email or SMS delivery 📧 📱
  • Customizable expiration time ⏰
  • Sequential or parallel signing workflow ⛓️
  • Custom email/SMS messages 💬
  • Webhook integration for real-time notifications 🔔
• send_signature_reminder 📬: Send reminder notifications to pending signers
• cancel_signature ❌: Cancel active signature requests with optional reason

Project Structure 📁

• cmd/server/main.go 🎯: Entry point of the application. It initializes and starts the MCP server.
• internal/app/server.go ⚙️: Contains the logic for creating and configuring the MCP server, including registering signature tools and handlers.
• internal/handlers/signature.go 🛠️: Implements handler functions for various signature operations such as listing, retrieving, and managing signatures.
• internal/tools/signature.go 🔧: Registers signature-related tools with the MCP server.

Configuration ⚙️

API Authentication 🔐

This server integrates with the Signaturit API and requires an API key for authentication. You need to:

1. Create an account at Signaturit
2. Get your API key from the Signaturit dashboard
3. Set the API key as an environment variable:

export SIGNATURIT_SECRET_TOKEN='your_api_key_here'

Prerequisites 📋

1. Go Installation

   • Go 1.16 or higher
   • Verify your installation:

   go version
   

2. Signaturit Account

   • Active account at Signaturit
   • Valid API key from the Signaturit dashboard

Build 🔨

1. Clone the repository

   git clone https://github.com/yourusername/signaturtit_mcp.git
   cd signaturtit_mcp
   

2. Install dependencies

   go mod download
   

3. Build the application

   # Build for your current platform
   go build -o bin/signaturtit_mcp cmd/server/main.go
   
   # Build for specific platform (e.g., Linux)
   GOOS=linux GOARCH=amd64 go build -o bin/signaturtit_mcp cmd/server/main.go
   

4. Run the built binary

   # Make sure you have set the required environment variables first
   export SIGNATURIT_SECRET_TOKEN='your_api_key_here'
   
   # Run the application
   ./bin/signaturtit_mcp
   

License 📜

Copyright 2024 Jordi Martin

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.