Build MCP Server: NEAR Wallet Operations for Claude

Overview

Create a production-ready MCP (Model Context Protocol) server that enables Claude to perform NEAR wallet operations directly in conversations.

Why This Matters

When users ask Claude about NEAR or need to interact with the blockchain, Claude should be able to help directly rather than just explaining. This tool makes Claude a powerful NEAR assistant.

Technical Requirements

MCP Server Implementation

// Required tools to implement:

// 1. create_near_account
// Creates a new NEAR account (named or implicit)
// Input: { account_type: "named" | "implicit", name?: string }
// Output: { account_id, public_key, seed_phrase }

// 2. get_account_balance
// Checks balance of any NEAR account
// Input: { account_id: string }
// Output: { available: string, staked: string, total: string }

// 3. send_near
// Transfers NEAR between accounts (requires user confirmation)
// Input: { from: string, to: string, amount: string }
// Output: { tx_hash, explorer_url }

// 4. get_transaction_status
// Checks status of a transaction
// Input: { tx_hash: string }
// Output: { status, block_height, gas_used }

// 5. list_access_keys
// Lists all access keys for an account
// Input: { account_id: string }
// Output: { keys: Array<{public_key, permission}> }

Security Requirements

• Never expose private keys in responses
• Require explicit user confirmation for any transaction
• Support both testnet and mainnet with clear indicators
• Implement rate limiting to prevent abuse

Code Quality

• Written in TypeScript with full type definitions
• Comprehensive error handling with helpful messages
• Unit tests with >80% coverage
• Clear inline documentation

Deliverables

1. Working MCP server - Published to npm as @anthropic-community/mcp-near-wallet
2. README with installation, configuration, and usage examples
3. Example conversations showing the tool in action
4. Security documentation explaining the safety measures

Publishing Requirements

• npm package published and installable
• Listed in MCP Registry at modelcontextprotocol.io
• GitHub repo with MIT license
• At least 3 example use cases documented

Success Criteria

• Tool installs and works with Claude Desktop
• All 5 core tools function correctly
• Can create accounts, check balances, and send NEAR
• Security measures prevent accidental fund loss

Budget: 15 NEAR

This is a foundational tool that will enable many other NEAR+Claude integrations.