Hashkey

Hashkey MCP Server provides onchain tools for AI applications, enabling seamless interaction with the Hashkey Network through a configurable MCP endpoint. It exposes a modular set of capabilities that you can extend with new tools, data sources, and protocols, so you can automate blockchain actions and data retrieval from your AI workflows.

How to use

You interact with the Hashkey MCP Server through a client that can issue tool commands. Start a local MCP process or connect to a remote MCP endpoint, then send requests that invoke the available tools, such as querying your wallet address, checking balances, transferring funds, deploying contracts, or listing and transferring NFTs. The server is designed to be extended with new tools and data sources, so you can tailor its capabilities to your AI workflows and onchain needs.

How to install

Prerequisites: ensure you have Node.js v16 or higher and npm or yarn installed.

Option 1: Install from npm (recommended)

# Install globally
npm install -g hashkey-mcp

# Or install locally in your project
npm install hashkey-mcp

Configure clients after installation using the following command.

hashkey-mcp --init

Option 2: Install from source

# 1. Clone the project
git clone https://github.com/HashkeyHSK/hashkey-mcp.git
cd hashkey-mcp

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Optionally, link it globally
npm link

Configuration and usage notes

Create a .env file with your credentials and necessary settings. The configuration shown includes keys for Coinbase, wallet seed phrase, onramp project, NFT tooling, and network chain information. You will supply your own values when you set up the environment.

Claude Desktop integration example

To add this MCP server to Claude Desktop, place the following configuration in your Claude Desktop configuration file and restart Claude Desktop.

{
  "mcpServers": {
    "hashkey-mcp": {
      "command": "npx",
      "args": ["-y", "hashkey-mcp@latest"],
      "env": {
        "COINBASE_API_KEY_NAME": "your_api_key_name",
        "COINBASE_API_PRIVATE_KEY": "your_private_key",
        "SEED_PHRASE": "your seed phrase here",
        "COINBASE_PROJECT_ID": "your_project_id",
        "ALCHEMY_API_KEY": "your_alchemy_api_key",
        "PINATA_JWT": "your_pinata_jwt",
        "OPENROUTER_API_KEY": "your_openrouter_api_key",
        "CHAIN_ID": "177"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available tools

get-address

Retrieves the address for your wallet.

list-balances

Lists all balances for your wallet.

transfer-funds

Transfers funds from your wallet to another address.

deploy-contract

Deploys a smart contract to the blockchain.

check-address-reputation

Checks the reputation of an address.

get_morpho_vaults

Gets the vaults for a given asset on Morpho.

call_contract

Calls a contract function on the blockchain.

get_onramp_assets

Gets the assets available for onramping in a country/subdivision.

onramp

Gets a URL for onramping funds via Coinbase.

erc20_balance

Gets the balance of an ERC20 token.

erc20_transfer

Transfers an ERC20 token to another address.

list_nfts

Lists NFTs owned by a specific address.

transfer_nft

Transfers an NFT to another address.

buy_openrouter_credits

Buys OpenRouter credits with USDC.