Skip to directory

Shutter Network MCP

Shutter Network

HTTP MCP at /mcp; README cites MCP 2024-11-056 documented tools0

About Shutter Network MCP

Experimental MCP for timelock message encryption on Gnosis Chiado testnet, with time parsing and status/decryption helpers.

Connection and setup
Hosting
Remote endpoint; local/Docker setup documented
Transport
HTTP MCP at /mcp; README cites MCP 2024-11-05
Endpoint
https://shutter-mcp-b76e270d48c5.herokuapp.com/mcp
Authentication
No MCP auth documented.

Requirements

  • Alpha/demo only; Chiado testnet and non-production encryption.
  • Self-host: Python 3.11+ and pip or Docker.

Setup steps

  1. Add endpoint to a remote HTTP MCP client; README gives Claude Web/VS Code examples.
  2. Local: clone; run scripts/deploy.sh then scripts/start.sh; endpoint localhost:5002/mcp.
  3. Or use documented Docker setup.
  4. Verify only with time conversion/explanation; do not send secrets or use production data.
Tools 6

Six current names were returned by the hosted tools/list endpoint. The maintainer explicitly labels this alpha/demo testnet software; do not treat its encryption as production-grade.

  • get_current_time

    Get the current date and time in UTC.

    01
  • get_unix_timestamp

    Get Unix timestamp for a given time expression or current time. This tool helps convert natural language time expressions to Unix timestamps that can be used with the Shutter API. Args: time_expression: Time to convert. Can be: - "now" for current time - Natural language like "3 months from now", "1 year from now" - Absolute dates like "2024-12-25" Returns: JSON string with Unix timestamp and human-readable date

    Parameters: time_expression
    02
  • timelock_encrypt

    Encrypt a message with timelock encryption using Shutter Network. This tool encrypts a message that can only be decrypted after a specified future time. The encryption is handled by the Shutter Network's decentralized keypers using threshold cryptography. IMPORTANT FOR LLM: This tool accepts BOTH Unix timestamps AND natural language time expressions. - Unix timestamps: Use numeric values like "1721905313" for precise future times - Natural language: Use expressions like "3 months from now", "1 year from now" - Absolute dates: Use formats like "2024-12-25" or "January 15, 2025" The Shutter API works with Unix timestamps internally. When users provide natural language, this tool converts it to Unix timestamps automatically. WORKFLOW: The LLM should directly call this tool with the user's time expression. No need to call get_unix_timestamp first - this tool handles all time parsing. Args: message: The text message to encrypt unlock_time: When the message can be decrypted. Accepts: - Unix timestamp (e.g., "1721905313") - Natural language (e.g., "3 months from now", "1 year from now") - Absolute date (e.g., "2024-12-25", "January 15, 2025") Returns: JSON string with encrypted data and instructions for future decryption

    Parameters: message, unlock_time
    03
  • check_decryption_status

    Check if a timelock encrypted message is ready for decryption. Args: identity: The identity returned from timelock_encrypt Returns: JSON string with status of the timelock and whether decryption is available

    Parameters: identity
    04
  • decrypt_timelock_message

    Decrypt a timelock encrypted message if the timelock has expired. Args: identity: The identity returned from timelock_encrypt encrypted_data: The encrypted data returned from timelock_encrypt Returns: JSON string with the decrypted message or error if timelock hasn't expired

    Parameters: identity, encrypted_data
    05
  • explain_timelock_encryption

    Explain how Shutter timelock encryption works and how to use this server. Returns: JSON string with comprehensive explanation of timelock encryption

    06
Limitations and notes
  • README says alpha/demo, Chiado testnet only, non-production encryption, no persistence/availability guarantees.
  • Endpoint not tested.
  • README feature claim ?production ready? conflicts with explicit warnings; warnings govern.
  • Five tool names in primary README vs six directory listing.
Source discrepancies
  • Five named in primary README vs six in directory listing; marked partial.
  • Production-ready bullet conflicts with explicit alpha/demo warning; warning governs.
Original sources
  • official documentation

    The current ShutterMCP repository describes an experimental timelock-encryption server and warns that it uses a demo algorithm and Gnosis Chiado testnet, not production cryptography. A direct tools/list request to the published endpoint returned six tools, including explain_timelock_encryption, beyond the five in the older catalog.

  • official tool reference

    The current ShutterMCP repository describes an experimental timelock-encryption server and warns that it uses a demo algorithm and Gnosis Chiado testnet, not production cryptography. A direct tools/list request to the published endpoint returned six tools, including explain_timelock_encryption, beyond the five in the older catalog.

Documentation checked 2026-10-28T13:19:36Z. Connection has not been runtime tested.