mcpField
N
NEAR MCP

NEAR MCP

Local
github.com/nearaiFinance31Updated 77w ago
Repository

About NEAR MCP

NEAR MCP is an MCP server for interacting with the NEAR blockchain. It is intended for LLMs and AI agents that need to access NEAR accounts and on-chain functionality, and it is designed to run locally.

Key features

  1. 01Manage NEAR accounts
  2. 02Check account balances and status
  3. 03Sign and send transactions
  4. 04Create accounts and manage access keys
  5. 05Inspect and execute smart contracts

Use cases

  1. 01Asking an AI assistant to check NEAR account balances
  2. 02Signing and sending transactions through an AI assistant
  3. 03Adding NEAR functions to a command-line MCP client

MCP support

The project is an MCP server that exposes NEAR account and blockchain tools to MCP-compatible clients, such as Claude Code, Claude Desktop and goose.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "near": {
      "command": "npx",
      "args": [
        "-y",
        "@nearai/near-mcp"
      ]
    }
  }
}
Run commandnpx -y @nearai/near-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@nearai/near-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README
NEAR MCP Logo

npm version Telegram

NEAR MCP

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

Quickstart

Here is how to get started with the near-mcp server quickly with the claude code cli

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

Or deploy the MCP server remotely on Phala Cloud, check the instructions here

Installing

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

Adding to the claude code cli:

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

Adding to claude desktop via JSON config:

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

Adding to goose

┌   goose-configure
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Command-line Extension
│
◇  What would you like to call this extension?
│  near-mcp
│
◇  What command should be run?
│  npx @nearai/near-mcp@latest run
│
◇  Please set the timeout for this tool (in secs):
│  60
│
◇  Would you like to add environment variables?
│  No
│
└  Added near-mcp extension

Or you can install it globally and use it directly.

# Install globally
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

This tool is designed to be used with AI models that support the Model Context Protocol. It enables AI assistants to:

  1. Manage NEAR accounts on behalf of users
  2. Check account balances and status
  3. Sign and send transactions
  4. Create new accounts and manage access keys
  5. Inspect and execution smart contracts

Security Considerations

  • This MCP is meant to be run locally. Account private keys are stored in a local unencrypted keystore where the MCP server is running.
  • The underlying models should not have access to see the private keys of the accounts they are interacting with with one exception. The import_account tool allows the model to import an account from a private key. This requires the user to provide the private key to the model.

Contributing

We welcome contributions to the NEAR MCP server! 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.