Token Revoke MCP

An MCP server for checking and revoking ERC-20 token allowances, enhancing security and control.

Features

• Fetch Token Approvals: Retrieve all ERC20 token approvals for a wallet on a specified chain, including token details, balances, and USD values at risk.
• Revoke Allowances: Submit transactions to revoke ERC20 token allowances for specific spenders.
• Check Transaction Status: Verify the success or failure of submitted transactions using transaction hashes.
• Multi-Chain Support: Supports over 50 EVM-compatible chains, including mainnets (e.g., Ethereum, Polygon, BSC) and testnets (e.g., Goerli, Mumbai).

Prerequisites

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

Installation

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

Below are examples of how you might interact with the server using natural language prompts as input. The outputs are the raw text values from the content array returned by the server, assuming a client translates the prompts into tool calls.

Example 1: Fetch Token Approvals

Input Prompt:

Output Response:

[
  {
    "tokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
    "tokenSymbol": "USDC",
    "balance": "100.5",
    "usdPrice": "1.00",
    "usdValueAtRisk": "50.25",
    "spenderAddress": "0x1111111254eeb25477b68fb85ed929f73a960582",
    "approvedAmount": "1000.0",
    "transactionHash": "0xabc...",
    "timestamp": "2023-10-01T12:00:00Z"
  }
]

Example 2: Revoke an Allowance

Input Prompt:

Output Response:

Allowance revocation submitted on bsc. Transaction hash: 0x123.... Note: Transaction is not yet confirmed.

Example 3: Check Transaction Status

Input Prompt:

Output Response (possible outputs):

• Pending:

  Transaction 0x123... on bsc is still pending or not found.
  

• Success:

  Transaction 0x123... on bsc has completed with status: successful. Block number: 12345.
  

• Failure:

  Transaction 0x123... on bsc has completed with status: failed. Block number: 12345.
  

Supported Chains

The server supports a wide range of EVM-compatible chains based on the Moralis JS SDK’s chaindata.ts. Examples include:

• Mainnets: ethereum, polygon, bsc, avalanche, fantom, arbitrum, optimism, etc.
• Testnets: goerli, mumbai, bsc testnet, arbitrum goerli, optimism sepolia, etc.
• Full list: See SUPPORTED_CHAINS in server.js.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!