MCP NEAR Liquid Staking Server

A Model Context Protocol (MCP) server for interacting with liquid staking protocols on NEAR blockchain. Supports Meta Pool (stNEAR) and Linear Protocol (LiNEAR).

Features

• stake_near - Stake NEAR tokens to receive liquid staking tokens (stNEAR or LiNEAR)

• unstake - Request unstaking of liquid tokens (starts the unbonding period)

• withdraw - Withdraw NEAR after the unstaking period completes

• get_staking_info - Query a user's staking position, balances, and pending withdrawals

• get_pool_stats - Get pool statistics including APY, TVL, exchange rate, and fees

• list_validators - List validators used by each staking pool

Related MCP server: NEAR Liquid Staking

Supported Protocols

Installation

npm install
npm run build

Usage

As MCP Server

Start the server:

npm start
# or
node dist/index.js

The server communicates over stdio using the MCP protocol.

MCP Configuration

Add to your MCP client configuration:

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

Tools

stake_near

Stake NEAR tokens on Meta Pool or Linear.

{
  "protocol": "meta-pool",
  "amount": "100",
  "accountId": "your-account.near"
}

Returns transaction data ready for signing. Estimated liquid tokens to receive are calculated based on current exchange rate.

unstake

Request unstaking. Initiates the unbonding period (~48 hours / 4 epochs).

{
  "protocol": "linear",
  "amount": "50",
  "accountId": "your-account.near"
}

withdraw

Withdraw NEAR after the unstaking period completes.

{
  "protocol": "meta-pool",
  "accountId": "your-account.near"
}

get_staking_info

Get user's complete staking position.

{
  "protocol": "meta-pool",
  "accountId": "your-account.near"
}

Response includes:

• stakedBalance - Total NEAR equivalent staked

• liquidTokenBalance - stNEAR/LiNEAR balance

• pendingWithdrawal - Amount in unbonding

• withdrawableBalance - Ready to withdraw

• epochsUntilWithdrawable - Epochs remaining until withdrawal

get_pool_stats

Get pool statistics and current rates.

{
  "protocol": "linear"
}

Response includes:

• totalStaked - Total NEAR staked in pool

• exchangeRate - Current NEAR per liquid token rate

• apy - Annual percentage yield

• tvlNear - Total value locked

• fee - Protocol fee percentage

• validatorCount - Number of validators

list_validators

List validators used by the staking pool.

{
  "protocol": "meta-pool"
}

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build
npm run build

Testing

npm test

Tests cover:

• Pool stats retrieval for both protocols

• Staking info queries

• Stake/unstake/withdraw transaction preparation

• Validator listing

• Edge cases (small/large amounts)

Architecture

src/
├── index.ts         # MCP server entry point with tool handlers
└── near-client.ts   # NEAR RPC client for staking operations

The server uses:

• @modelcontextprotocol/sdk - MCP server implementation

• near-api-js - NEAR blockchain interaction

• zod - Input validation

Notes

• Transaction Signing: This server prepares transaction data but does not sign transactions. The consuming application must handle wallet integration and signing.

• RPC Endpoints: Uses public NEAR RPC endpoints. For production, consider using a dedicated RPC provider.

• Exchange Rates: Liquid token amounts are calculated based on current exchange rates which may vary slightly at execution time.

License

MIT