Sui Serverless MCP Server: Secure Interactions on the Sui Blockchain

Overview: What is Sui Serverless MCP Server?

Sui Serverless MCP (Model Context Protocol) Server is a sophisticated backend service implementing the Model Context Protocol, designed to facilitate secure and seamless interactions between AI applications and the Sui blockchain. By leveraging zkLogin authentication, it provides a fully non-custodial environment where AI agents can perform on-chain operations without requiring users to manage their own keys or write complex code.

Features & MCP Capabilities

This server integrates with various MCP-compatible clients such as Claude Desktop, Continue, Cursor, and more. It supports over 10 tools covering account management, token operations, staking, and additional functionalities like token swaps on Mainnet via the Cetus DEX Aggregator. The system ensures that transactions are executed securely through zkLogin wallets, offering robust protection against unauthorized access.

MCP Architecture & Protocol Implementation

The architecture of Sui Serverless MCP is built using the AWS Serverless Stack, which includes backend services and a dashboard for managing access keys and transactions in zkLogin mode. This setup ensures efficient and secure processing of requests from AI applications while maintaining high levels of data privacy.

Components

1. Sui Serverless MCP Client – A Node.js TypeScript library designed to run inside MCP-compatible clients, enabling them to interact with the Sui blockchain.
2. Sui Serverless MCP Core – The backend system built using AWS Serverless Stack to include a dashboard for issuing access keys and managing transactions through zkLogin.

Protocol Flow Diagram

graph TD
    A[AI Application] -->|MCP Client| B[MCP Protocol]
    B --> C[Sui Serverless MCP Core]
    C --> D[zkLogin Wallets/Data Source/Tool]
    style A fill:#e1f5fe
    style C fill:#f8c4b0
    style D fill:#c9e6bc

Use Cases

Real-World Scenario 1: Token Management for Financial Advisors

A financial advisor can use Sui Serverless MCP to manage client assets on the Sui blockchain. By deploying tokens, transferring funds, and checking balances directly from a chat interface, advisors can provide real-time financial advice and execute transactions seamlessly.

graph TD
    T[User Request] -->|MCP Client| C[MCP Core]
    C -->|Transaction| D[(zkLogin Wallet)]
    D -->|Confirm| E[Perform Transaction on Sui Blockchain]

Real-World Scenario 2: Identity Verification for Decentralized Exchanges

A decentralized exchange can use the SDK to verify user identities and perform trades without storing private keys. The zkLogin protocol ensures that users' credentials remain secure, while AI applications gain access to necessary transaction capabilities.

Getting Started with Installation

Installation Steps

1. Install Claude Desktop if you haven't already.
2. Configure the MCP Client in your configuration file:

{
  "mcpServers": {
    "sui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sui-serverless-mcp",
        "--sui_access_key=YOUR_ACCESS_KEY", 
        "--sui_network=mainnet"
      ],
      "disabled": false
    }
  }
}

Replace YOUR_ACCESS_KEY with the actual access key generated from the dashboard. This setup ensures that your AI application can communicate with Sui Serverless MCP securely.

Key Use Cases in AI Workflows

Wallet Operations

• **sui_get_wallet_address
• Example Usage: "What's my wallet address for Sui?"

Token Transfers

• **sui_transfer_token
• Example Usage: "Transfer 10 SUI to domain.sui"

Staking Operations

• **sui_stake

• Example Usage: "Stake 100 SUI to validator 0x1234"

• **sui_get_stake

• Example Usage: "Show my staked positions"

• **sui_unstake

• Example Usage: "Unstake SUI on this staked sui 0x4567"

Token Management

• **sui_deploy_token
• Example Usage: "Create a token named MyToken with symbol MTK"

SNS Domain Services

• **sui_get_sns_name_record

• Example Usage: "Look up info about domain.sui"

• **sui_register_sns

• Example Usage: "Register myname.sui for 2 years"

DeFi Operations

• **sui_get_swap_quote

• Example Usage: "If I want to swap 10 SUI for NAVI, how much NAVI will I get?"

• **sui_swap_tokens

• Example Usage: "Swap 10 SUI to NAVI now"

Integration with MCP Clients

zkLogin Mode & Private Key Mode

zkLogin Mode

With zkLogin authentication:

• Read operations work immediately.
• Write operations require explicit approval on the dashboard.

Private Key Mode

All operations are executed automatically without requiring additional approval.

Performance & Compatibility Matrix

MCP Client	Resources	Tools	Prompts	Status
Claude Desktop	✅	✅	✅	Full Support
Continue	✅	✅	✅	Full Support
Cursor	❌	✅	❌	Tools Only

Advanced Configuration & Security

Troubleshooting

Ubuntu or other Linux environments with NVM might require manual path configuration. Follow these steps:

1. Install the MCP Client globally under your current NVM-managed Node.js version:

npm install -g sui-serverless-mcp

2. Configure your AI application's config file using absolute paths:

   {
     "mcpServers": {
       "sui-mcp": {
         "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
         "args": [
           "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/sui-serverless-mcp",
           "--sui_access_key=YOUR_ACCESS_KEY",
           "--sui_network=mainnet"
         ]
       }
     }
   }
   

3. Restart Claude Desktop.

Frequently Asked Questions (FAQ)

1. Q: How does Sui Serverless MCP ensure security?

2. A: Sui Serverless MCP leverages zkLogin for secure authentication, ensuring that user data remains private while enabling AI applications to perform on-chain operations seamlessly.

3. Q: Can I use Sui Serverless MCP with different MCP clients?

4. A: Yes, it supports multiple MCP clients like Claude Desktop, Continue, and Cursor, providing a versatile solution for integrating with various AI models and interfaces.

5. Q: How do I obtain an access key for using zkLogin Mode?

6. A: Access keys can be generated from the dashboard. After logging in with your credentials, you will receive a unique key to secure your transactions.

7. Q: What are the benefits of using Sui Serverless MCP over traditional blockchain solutions?

8. A: Sui Serverless MCP offers advanced security features like zkLogin and non-custodial access control, making it ideal for AI applications requiring high levels of privacy and secure interaction with the blockchain.

9. Q: Can I customize the tools available in Sui Serverless MCP?

10. A: Yes, you can extend the functionality by deploying additional tools or integrating third-party services through the API provided by the server.

Conclusion

Sui Serverless MCP is a powerful backend service that significantly enhances AI applications through secure and non-custodial interactions with the Sui blockchain. Whether you are developing financial tools, decentralized exchanges, or identity verification systems, Sui Serverless MCP offers robust technical capabilities to support your projects.

Technical Support & Resources

For more information and additional resources, please visit the Sui Serverless MCP documentation or contact our support team at [email protected] for assistance with configuration and integration.