MCP NEAR Testnet

An MCP server for safe NEAR blockchain experimentation. Hardcoded to testnet only - perfect for learning, testing contracts, and development.

Features

• create_testnet_account - Create new testnet accounts with generated keys
• request_faucet - Get free testnet NEAR tokens
• deploy_contract - Deploy WASM smart contracts
• call_contract - Call contract methods (view and change)

Safety

This server is testnet-only by design. The network is hardcoded and cannot be changed - there's no risk of accidentally using mainnet funds.

Installation

npm install
npm run build

Configuration

Optional environment variables:

# Path to store testnet keys (default: ./testnet-keys.json)
export NEAR_KEYS_PATH=./my-testnet-keys.json

Usage with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "near-testnet": {
      "command": "node",
      "args": ["/path/to/mcp-near-testnet/dist/index.js"]
    }
  }
}

Example Workflows

Create an Account and Get Tokens

1. "Create a testnet account called my-test-app"
2. "Request faucet tokens for my-test-app.testnet"

Deploy and Test a Contract

1. "Deploy the contract at ./target/wasm32/my_contract.wasm to my-test-app.testnet"
2. "Call the 'get_greeting' method on my-test-app.testnet as a view call"
3. "Call 'set_greeting' with args {message: 'Hello'} on my-test-app.testnet, sign with my-test-app.testnet"

Key Storage

Private keys for created accounts are stored in testnet-keys.json (or the path specified by NEAR_KEYS_PATH).

⚠️ These are testnet keys only - still, don't commit them to git. Add to .gitignore:

testnet-keys.json

License

MIT