Shutter

A Model Context Protocol (MCP) server that provides timelock encryption capabilities using the Shutter Network.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

Shutter MCP provides timelock encryption via the Shutter Network, allowing you to send messages that can only be decrypted after a chosen future time. This enables trustless time-delayed communications for plans, announcements, or sensitive notes that should unlock later.

How to use

You interact with the Shutter MCP server through an MCP client. Create a timelock encrypted message by specifying the content you want to protect and the unlock time. The system will return an identity for your encrypted payload. You can later check whether the timelock has expired and, if it has, decrypt the message using the provided identity. Use natural language expressions like "3 months from now" or a Unix timestamp or an exact date to set the unlock time. This lets you schedule messages to be revealed at a precise moment in the future.

How to install

Prerequisites: you need Python 3.11 or higher and pip installed.

Clone or download the server package.

git clone <your-repo-url>
cd shutter-mcp-server

Run the deployment script to set up the environment.

./scripts/deploy.sh

Start the server.

./scripts/start.sh

The server will be available at the local address shown in the startup output, typically http://localhost:5002 with the MCP endpoint at http://localhost:5002/mcp.

Optional: to run locally with Docker Compose, or to build and run the container manually, follow the Docker deployment steps.

Available tools

timelock_encrypt

Encrypt a message with timelock encryption using the Shutter Network. Parameters include the message string and the unlock_time expression.

check_decryption_status

Check whether a timelock encrypted message is ready for decryption using the identity returned from timelock_encrypt.

decrypt_timelock_message

Decrypt the timelock encrypted message after the unlock time has passed, using the identity and the encrypted data.

get_unix_timestamp

Convert time expressions to Unix timestamps for precise timing.

explain_timelock_encryption

Provide a comprehensive explanation of timelock encryption and its usage.