PortalMCP Server

Bridges AI models with Ethereum actions, enabling contract deployment, token and NFT operations, and DeFi tasks via natural language.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "portalfnd-portalmcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/portalmcp/dist/index.js"
      ],
      "env": {
        "INFURA_API_KEY": "your_infura_key",
        "ETHEREUM_NETWORK": "mainnet",
        "DEPLOYER_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

PortalMCP is an integration layer that lets you perform Ethereum blockchain actions through natural language across multiple AI platforms. You can generate, deploy, and interact with contracts; handle ERC-20 tokens and NFTs; and perform DeFi and general blockchain tasks using your preferred AI model without writing low-level code.

How to use

You connect your MCP client to PortalMCP as a local or remote server and start the MCP services. Once connected, you can issue natural language requests to an AI model, and PortalMCP translates them into Ethereum actions such as creating tokens, deploying contracts, minting NFTs, querying balances, and sending transactions. Start from a trusted provider you already use (Claude Desktop, ChatGPT, or another supported platform) and enable the MCP bridge so your model can call the available tools.

How to install

Prerequisites: install Node.js v16 or higher, ensure npm or yarn is available, and have an Ethereum wallet ready (MetaMask recommended). You should also have access to a Claude API key if you intend to use Claude as the MCP client.

# 1) Clone the repository
git clone https://github.com/PortalFnd/portalmcp.git
cd portalmcp

# 2) Install dependencies
npm install

# 3) Create environment configuration
cp .env.example .env

# 4) Populate required keys in .env
# Example keys you would normally set
# ETHEREUM_NETWORK=mainnet
# INFURA_API_KEY=your_infura_key
# DEPLOYER_PRIVATE_KEY=your_private_key

Additional setup and usage notes

Start the MCP server with the standard start command for your environment. For the Claude Desktop setup, you will run the Node.js process with its path and environment variables. For REST API and other integrations, you may start a local API server and then connect to Portalmcp through your chosen AI platform.

Available tools

eth_generate_contract

Generate Solidity code for a new contract based on user requirements.

eth_compile_contract

Compile Solidity source to bytecode and ABI.

eth_deploy_contract

Deploy a compiled contract to the selected Ethereum network.

eth_create_token

Create a new ERC-20 token and initialize its supply and metadata.

eth_get_token_balance

Query the balance of a given ERC-20 token for an address.

eth_transfer_token

Transfer ERC-20 tokens between addresses.

eth_create_nft_collection

Deploy a new NFT collection contract.

eth_mint_nft

Mint a new NFT within a collection to a recipient.

eth_get_nft_owner

Query the owner of a specific NFT token.

eth_create_staking_contract

Create a staking contract for token staking mechanics.

eth_stake_tokens

Stake tokens into a specified staking contract.

eth_swap_tokens

Swap tokens on a decentralized exchange via a contract interaction.

eth_get_balance

Get the ETH balance for an address.

eth_call_contract

Call a contract function without changing state.

eth_send_transaction

Send a signed transaction to the network.

Built by

VeilStrat

AI signals for GTM teams