Token Revoke MCP

1# Token Revoke MCP
2 
3An MCP server for checking and revoking ERC-20 token allowances, enhancing security and control.
4 
5![License](https://img.shields.io/badge/license-MIT-blue.svg)
6![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Fetch Token Approvals**: Retrieve all ERC20 token approvals for a wallet on a specified chain, including token details, balances, and USD values at risk.
12- **Revoke Allowances**: Submit transactions to revoke ERC20 token allowances for specific spenders.
13- **Check Transaction Status**: Verify the success or failure of submitted transactions using transaction hashes.
14- **Multi-Chain Support**: Supports over 50 EVM-compatible chains, including mainnets (e.g., Ethereum, Polygon, BSC) and testnets (e.g., Goerli, Mumbai).
15 
16## Prerequisites
17 
18- **Node.js**: Version 18 or higher (for native `fetch` support).
19- **Moralis API Key**: Required for fetching token approval data.
20- **Private Key**: An Ethereum-compatible private key for signing revocation transactions.
21 
22## Installation
23 
241. **Clone the Repository**:
25   ```bash
26   git clone https://github.com/kukapay/token-revoke-mcp.git
27   cd token-revoke-mcp
28   ```
29 
302. **Install Dependencies**:
31   ```bash
32   npm install
33   ```
34   
353. **Client Configuration**:
36 
37    ```json
38    {
39      "mcpServers": {
40        "token-revoke-mcp": {
41          "command": "node",
42          "args": ["path/to/token-revoke-mcp/index.js"],
43          "env": {
44            "MORALIS_API_KEY": "your moralis api key",
45            "PRIVATE_KEY": "your wallet private key"
46          }
47        }
48      }
49    }   
50    ```
51 
52## Usage
53 
54Below 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.
55 
56### Example 1: Fetch Token Approvals
57**Input Prompt**:  
58> "Show me all the token approvals for my wallet on Polygon."
59 
60**Output Response**:  
61```
62[
63  {
64    "tokenAddress": "0x2791bca1f2de4661ed88a30c99a7a9449aa84174",
65    "tokenSymbol": "USDC",
66    "balance": "100.5",
67    "usdPrice": "1.00",
68    "usdValueAtRisk": "50.25",
69    "spenderAddress": "0x1111111254eeb25477b68fb85ed929f73a960582",
70    "approvedAmount": "1000.0",
71    "transactionHash": "0xabc...",
72    "timestamp": "2023-10-01T12:00:00Z"
73  }
74]
75```
76 
77### Example 2: Revoke an Allowance
78**Input Prompt**:  
79> "Revoke the allowance for token 0x2791bca1f2de4661ed88a30c99a7a9449aa84174 to spender 0x1111111254eeb25477b68fb85ed929f73a960582 on BSC."
80 
81**Output Response**:  
82```
83Allowance revocation submitted on bsc. Transaction hash: 0x123.... Note: Transaction is not yet confirmed.
84```
85 
86### Example 3: Check Transaction Status
87**Input Prompt**:  
88> "Did my transaction 0x123... on BSC go through?"
89 
90**Output Response** (possible outputs):  
91- **Pending**:  
92  ```
93  Transaction 0x123... on bsc is still pending or not found.
94  ```
95- **Success**:  
96  ```
97  Transaction 0x123... on bsc has completed with status: successful. Block number: 12345.
98  ```
99- **Failure**:  
100  ```
101  Transaction 0x123... on bsc has completed with status: failed. Block number: 12345.
102  ```
103 
104## Supported Chains
105 
106The server supports a wide range of EVM-compatible chains based on the Moralis JS SDK’s `chaindata.ts`. Examples include:
107- Mainnets: `ethereum`, `polygon`, `bsc`, `avalanche`, `fantom`, `arbitrum`, `optimism`, etc.
108- Testnets: `goerli`, `mumbai`, `bsc testnet`, `arbitrum goerli`, `optimism sepolia`, etc.
109- Full list: See `SUPPORTED_CHAINS` in `server.js`.
110 
111 
112## License
113 
114This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
115 
116