npm package: @colygon/polygon-mcp
Description: A Model Context Protocol (MCP) server that provides onchain tools for Claude AI, allowing it to interact with the Polygon PoS blockchain
Author: Dablclub
Latest version: 1.0.1

# Polygon MCP Server

A Model Context Protocol (MCP) server that provides onchain tools for Claude AI, allowing it to interact with the Polygon PoS blockchain.

## Features

- Call contract functions on Polygon PoS
- Get ERC20 token balances
- Transfer ERC20 tokens
- Get current gas prices

## Installation

### Option 1: Install from npm (Recommended)

```bash
npm install -g @colygon/polygon-mcp
```

This will install the Polygon MCP server globally on your system.

### Option 2: Install from source

1. Clone this repository:
```bash
git clone https://github.com/Dablclub/polygon-mcp.git
cd polygon-mcp
```

2. Install dependencies:
```bash
npm install
```

3. Build the project:
```bash
npm run build
```

## Configuration

Create a `.env` file in the root directory with the following variables:

```
SEED_PHRASE="your twelve word seed phrase here"
```

## Usage

### Running the server

If installed globally via npm:
```bash
polygon-mcp
```

If installed from source:
```bash
npm start
```

### Testing the server

A test script is included to demonstrate how to use the Polygon MCP server tools:

```bash
node test-polygon-mcp.js
```

This script will show examples of how to use each of the available tools in Claude.

### Using with Claude

To use this MCP server with Claude, you need to add it to your MCP settings file:

#### If installed globally via npm:

For VSCode Claude extension:
```json
{
  "mcpServers": {
    "polygon": {
      "command": "polygon-mcp",
      "env": {
        "SEED_PHRASE": "your twelve word seed phrase here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

For Claude desktop app:
```json
{
  "mcpServers": {
    "polygon": {
      "command": "polygon-mcp",
      "env": {
        "SEED_PHRASE": "your twelve word seed phrase here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

#### If installed from source:

For VSCode Claude extension:
```json
{
  "mcpServers": {
    "polygon": {
      "command": "node",
      "args": ["/path/to/polygon-mcp/build/index.js"],
      "env": {
        "SEED_PHRASE": "your twelve word seed phrase here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

For Claude desktop app:
```json
{
  "mcpServers": {
    "polygon": {
      "command": "node",
      "args": ["/path/to/polygon-mcp/build/index.js"],
      "env": {
        "SEED_PHRASE": "your twelve word seed phrase here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

## Available Tools

### call_contract

Call a contract function on Polygon PoS.

Parameters:
- `contractAddress`: The address of the contract to call
- `functionName`: The name of the function to call
- `functionArgs`: The arguments to pass to the function
- `abi`: The ABI of the contract
- `value` (optional): The value of MATIC to send with the transaction

### erc20_balance

Get the balance of an ERC20 token on Polygon PoS.

Parameters:
- `contractAddress`: The address of the contract to get the balance of

### erc20_transfer

Transfer an ERC20 token on Polygon PoS.

Parameters:
- `contractAddress`: The address of the contract to transfer the token from
- `toAddress`: The address of the recipient
- `amount`: The amount of tokens to transfer

### get_gas_price

Get the current gas price on Polygon PoS.

## MCP Marketplace Submission

This MCP server is being submitted to the [Cline MCP Marketplace](https://github.com/cline/mcp-marketplace). The submission details can be found in the `mcp-marketplace-submission.md` file.

To complete the submission, you'll need to:
1. Create a new issue in the MCP Marketplace repository
2. Follow the submission steps outlined in the `mcp-marketplace-submission.md` file
3. Attach the logo image (`assets/logo.png`) to your submission

## License

MIT