# BSC MCP Server with four.meme

A Model Context Protocol (MCP) server for Binance Smart Chain (BSC), with an end-to-end tool to create tokens on four.meme and submit the on-chain `createToken` transaction.

## Features

- Wallet address and BNB balance
- ERC20 transfers and token balance
- Contract execution and deploy
- PancakeSwap swap helper
- four.meme token creation (API flow + on-chain createToken)

## Requirements

- Node.js 18+ (required for `fetch`/`FormData`)
- A BSC wallet seed phrase
- Optional: Coinbase API credentials (only used by other tools)

## Setup

Install dependencies:

```bash
npm install
```

Build:

```bash
npm run build
```

Set environment variables (example):

```bash
SEED_PHRASE="your 12 or 24 word seed phrase"
COINBASE_API_KEY_NAME=""
COINBASE_API_PRIVATE_KEY=""
COINBASE_PROJECT_ID=""
```

## Claude Desktop config

```json
{
  "mcpServers": {
    "bsc-mcp": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/bsc-mcp-new/build/index.js"],
      "env": {
        "SEED_PHRASE": "your seed phrase"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

## four.meme tool

Tool name: `fourmeme_create_token`

Required fields:
- `name`
- `shortName`
- `desc`
- `label`
- `launchTime`
- `webUrl` (must be `https://...`)
- `imgUrl` (or `imagePath` if uploading locally)

Example:

```json
{
  "name": "Testing",
  "shortName": "TEST",
  "desc": "Test token",
  "label": "Meme",
  "launchTime": 1737331800000,
  "imgUrl": "https://static.four.meme/market/your-image.jpg",
  "webUrl": "https://example.com"
}
```

If you want local upload, put the image inside `/Users/username/Documents/coding` (or grant Full Disk Access to Claude) and pass `imagePath`.

## Security

Never commit secrets or seed phrases. Use local `.env` files or your MCP config.