kukapay/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**:
2. **Install Dependencies**:
3. **Client Configuration**:
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**:
> "Show me all the token approvals for my wallet on Polygon."
**Output Response**:
Example 2: Revoke an Allowance
**Input Prompt**:
> "Revoke the allowance for token 0x2791bca1f2de4661ed88a30c99a7a9449aa84174 to spender 0x1111111254eeb25477b68fb85ed929f73a960582 on BSC."
**Output Response**:
Example 3: Check Transaction Status
**Input Prompt**:
> "Did my transaction 0x123... on BSC go through?"
**Output Response** (possible outputs):
- **Pending**:
- **Success**:
- **Failure**:
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.