📌Overview

Purpose: The NEAR MCP framework enables secure interactions between AI agents and the NEAR blockchain, facilitating access to blockchain functionalities for large language models (LLMs).

Overview: NEAR MCP is a Model Context Protocol (MCP) compatible server that facilitates AI models and agents to interact with NEAR accounts and blockchain features. It allows efficient management of blockchain operations while ensuring security for user data.

Key Features:

Secure Account Management: Enables AI agents to manage NEAR accounts, perform transactions, and handle access keys without exposing sensitive data.
Comprehensive Blockchain Interaction: Supports functions like checking balances, signing transactions, and executing smart contracts, thus enhancing the capabilities of AI models in blockchain environments.

NEAR MCP

NEAR MCP is a Model Context Protocol (MCP) compatible server for interacting with the NEAR blockchain. It provides a secure way for LLMs and AI agents to access and interact with NEAR accounts and blockchain functionality.

Quickstart

Get started quickly with the near-mcp server using the claude code CLI:

npm install -g @anthropic-ai/claude-code
claude mcp add near-mcp npx @nearai/near-mcp@latest run
claude

Installing

near-mcp is designed to be used with an MCP compatible client. Learn more in the MCP docs.

With `claude` code CLI:

claude mcp add near-mcp npx @nearai/near-mcp@latest run

With `claude` desktop (JSON config):

{
  "mcpServers": {
    "near-mcp": {
      "command": "npx",
      "args": ["-y", "@nearai/near-mcp@latest", "run"],
      "env": {}
    }
  }
}

With `goose`:

Run goose-configure and add a Command-line Extension with the following details:

Extension name: near-mcp
Command: npx @nearai/near-mcp@latest run
Timeout: 60 seconds
Environment variables: No

Global installation

npm install -g @nearai/near-mcp@latest

# Or use directly with npx
npx @nearai/near-mcp@latest run

Available Tools

See TOOLS.md for a list of available tools and arguments.

Integration with AI Models

NEAR MCP enables AI assistants supporting the Model Context Protocol to:

Manage NEAR accounts on behalf of users
Check account balances and status
Sign and send transactions
Create new accounts and manage access keys
Inspect and execute smart contracts

Security Considerations

This MCP server is intended to run locally. Account private keys are stored in a local unencrypted keystore.
Models should not access private keys except via the import_account tool, which requires user-provided private keys.

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for more information.

Reporting Issues

If you find a bug or have a feature request, please open an issue on the GitHub repository.

near-mcp