Society Abstract MCP is a FastMCP TypeScript server that provides wallet, token, and smart contract utilities on the Abstract Testnet and Mainnet. It enables you to check balances, transfer tokens, deploy ERC-20 tokens, create Abstract Global Wallets, and generate EOAs, all through a streamlined MCP client workflow.

How to use

You can interact with Society Abstract MCP using an MCP client to perform common blockchain actions. Use the NPX-based run for quick access or run a local build for full control. Specifically, you can check balances, transfer ETH or ERC-20 tokens, deploy new tokens, create smart contract accounts, and generate new wallets. Each operation is designed to support ENS names alongside direct addresses for convenience.

Key capabilities you will use include balance checks for native ETH or ERC-20 tokens, transfers of native ETH or tokens, deploying an ERC-20 token contract, creating an Abstract Global Wallet, and generating new EOAs. When interacting with the server, you provide signer information, recipient addresses, token identifiers, and amounts in human-readable formats as described in each operation’s parameters.

How to install

Prerequisites you need installed on your machine: Node.js (version 16 or newer) and npm. You may also use npx for quick MCP server execution.

Step 1: Install dependencies for development or preparation to run the MCP server in a local environment.

Step 2: Build the project if you plan to run a production-like server from dist artifacts.

Step 3: Run the MCP server using the preferred method shown in the configuration examples below.

Configuration and run options

{
  "mcpServers": {
    "society-abstract-mcp": {
      "command": "npx",
      "args": ["-y", "society-abstract-mcp@0.1.4"],
      "env": {
        "ABSTRACT_PRIVATE_KEY": "your-private-key-here",
        "ABSTRACT_RPC_URL": "https://api.testnet.abs.xyz",
        "TESTNET": "true",
        "PORT": "3101",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Local development run

{
  "mcpServers": {
    "society-abstract-mcp-local": {
      "command": "node",
      "args": ["/path/to/your/society_abstract_mcp/dist/server.js"],
      "env": {
        "ABSTRACT_PRIVATE_KEY": "your-private-key-here",
        "ABSTRACT_RPC_URL": "https://api.testnet.abs.xyz",
        "TESTNET": "true",
        "PORT": "3101",
        "MCP_DISABLE_PINGS": "true"
      }
    }
  }
}

Environment variables

The following environment variables are used when running the MCP client against the Abstract network. Provide them in your runtime environment.

Build & Deploy

Build for production, then start the production server. The typical sequence is to install dependencies, build, and then start.

# Build for production
npm run build

# Start production server
npm start

Note: Build outputs are placed in dist/ with ES2022-compatible modules.

## Testing and development

Run unit tests to verify behavior, and integration tests when you have testnet funds. You can also use a balance tool to check multiple networks.

Unit tests

npm run test

Integration tests (requires funds)

INTEGRATION=1 npm run test:int

Balance checker tool

npm run balance

## Security note

When generating or handling private keys, store them securely and never log them. Private keys grant access to funds and should be protected in secure vaults or hardware wallets.

## Available tools

### ab\_get\_balance

Balance Checker. Retrieves native ETH or ERC-20 token balances for an address, with optional token contract address or token symbol, and supports ENS names.

### ab\_transfer\_token

Token Transfer. Transfers native ETH or ERC-20 tokens to a recipient address or ENS name, with optional token contract address or token symbol.

### ab\_deploy\_token\_erc20

ERC-20 Token Deployment. Deploys a new ERC-20 BasicToken contract to the Abstract network with a given name, symbol, and initial supply.

### ab\_agw\_create\_wallet

Abstract Global Wallet Creation. Deploys a new smart contract-based wallet (AGW) for a given signer.

### ab\_generate\_wallet

EOA Wallet Generation. Generates a brand-new externally owned account, returning a private key and address. Security note: private keys must be stored securely.