Safe MCP Server

🚀 Secure MCP Server

A Secure MCP (Model Context Protocol) server implementation for interacting with Safe (formerly Gnosis Safe) smart contract wallets.

🚀 Quick Start

The Secure MCP Server allows seamless interaction with Safe smart contract wallets. It comes pre - configured to use the Safe transaction mainnet endpoint, so you can start using it right away.

✨ Features

• Query all transactions for any Safe address.
• Retrieve detailed information about multisig transactions.
• Decode transaction data.
• Integrate with the Safe API.

📦 Installation

npm install

💻 Usage Examples

Basic Usage

To start the server, first build the project and then start it:

npm run build
npm start

No configuration is required - the server uses the Safe transaction mainnet endpoint by default.

Advanced Usage

getSafeTransactions

Retrieve all transactions for any Safe address determined by the context. The address is dynamically determined by the LLM at runtime.

// Example tool call
getSafeTransactions({
  address: "0x123...", // Safe address determined in the context
  limit: 100, // Optional parameter
  offset: 0, // Optional parameter
});

getMultisigTransaction

Get detailed information about a specific multisig transaction.

getMultisigTransaction({
  safeTxHash: "0x456...", // Transaction hash to query
});

decodeTransactionData

Decode transaction data using the Safe API.

decodeTransactionData({
  data: "0x789...", // Data part to be decoded
  to: "0xabc...", // Optional target contract address
});

🔧 Configuration (Optional)

By default, the server uses the Safe transaction mainnet endpoint:

https://safe-transaction-mainnet.safe.global/api/v1

If you need to use a different endpoint (e.g., a testnet), you can set it via an environment variable:

SAFE_API_URL=https://safe-transaction-goerli.safe.global/api/v1 npm start

🔨 Development

To start the development server:

npm run dev

📄 License

MIT