Token Revoke MCP

🚀 Token Revoke MCP Server

A Multi-Chain Proxy (MCP) server for checking and revoking ERC-20 token approvals, enhancing security and control.

🚀 Quick Start

This Token Revoke MCP Server is designed to help you manage ERC-20 token approvals on multiple EVM-compatible chains. It provides functions such as retrieving token approvals, revoking permissions, and checking transaction statuses.

✨ Features

• Get Token Approvals: Retrieve all ERC20 token approvals for a wallet on a specific chain, including token details, balances, and the dollar value at risk.
• Revoke Approvals: Submit a transaction to revoke ERC20 token approvals for a specific spender.
• Check Transaction Status: Verify the success or failure status of a submitted transaction via its transaction hash.
• Multi-Chain Support: Supports over 50 EVM-compatible chains, including mainnets (e.g., Ethereum, Polygon, BSC) and testnets (e.g., Goerli, Mumbai).

📦 Installation

Prerequisites

• Node.js: Version 18 or higher (for native fetch support).
• Moralis API Key: Used to obtain token approval data.
• Private Key: An Ethereum-compatible private key for signing revocation transactions.

Steps

1. Clone the repository:

   git clone https://github.com/kukapay/token-revoke-mcp.git
   cd token-revoke-mcp
   

2. Install dependencies:

   npm install
   

3. Client configuration:

   {
     "mcpServers": {
       "token-revoke-mcp": {
         "command": "node",
         "args": ["path/to/token-revoke-mcp/index.js"],
         "env": {
           "MORALIS_API_KEY": "Your Moralis API Key",
           "PRIVATE_KEY": "Your wallet private key"
         }
       }
     }
   }   
   

💻 Usage Examples

Basic Usage

Here are examples of interacting with the server using natural language prompts:

Example 1: Get Token Approvals

Input Prompt:

"Show me all my token approvals on Polygon."

Output Response:

[
  {
    "tokenAddress": "0x2a65Lend (actual address)",
    "tokenName": "DAI",
    "tokenSymbol": "DAI",
    "tokenDecimals": 18,
    "spender": "0xspenderAddress",
    "authorizedAmount": "1000000",
    "timestamp": "2023-10-01T12:00:00Z"
  }
]

Example 2: Revoke Approvals

Input Prompt:

"Please revoke my approval for the token DAI to the spender on Polygon."

Output Response:

Transaction Hash: 0xtransactionHash
Status: Success

Example 3: Check Transaction Status

Input Prompt:

"Please tell me the status of transaction 0x1234."

Output Response:

Transaction Hash: 0x1234
Status: Failed (Reason: insufficient funds)

📚 Documentation

Supported Chains

• Mainnets: Ethereum, Polygon, BSC, Avalanche, Fantom, Arbitrum, Optimism, etc.
• Testnets: Goerli, Mumbai, BSC Testnet, Arbitrum Goerli, Optimism Sepolia, etc.
• Full List: Refer to SUPPORTED_CHAINS in server.js.

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.