# NEARpedia

> NEARpedia is a free MCP server for developer tools. Dated, sourced answers about NEAR deprecations, breaking changes and protocol state. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://near-pedia.xyz/for-ai
- **Repository:** https://github.com/unitynodes/near-pedia
- **MCP Registry name:** io.github.UnityNodes/near-pedia
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Agents often write NEAR code from stale memory. This server checks it against current sources: whether a package, crate, RPC method or config key is deprecated, what replaced it, and what changed between two versions of a product. Every answer carries a source and a date. The README gives examples such as near-sdk-js being archived and nearcore 2.14.0 removing DelegateV2.

The deprecation engine draws on six signals, including archived repositories, README warnings, npm and crates.io flags, release-note removals and docs deletions; weak signals are labelled possibly deprecated. Beyond code checks there are tools for known issues, error explanations, NEP standards, live protocol status, and governance and forum threads. The index covers docs.near.org, NEAR GitHub orgs and gov.near.org.

The endpoint needs no key and has no write tools. The site counts 48 MCP tools and a REST API, though the page lists 27. The project was built for the NEAR Hackathon.

## Features

- **Deprecation checks:** Tells whether a package, crate, RPC method or feature is deprecated and what replaced it.
- **Breaking changes:** Lists removals and deprecations between two versions of a NEAR product.
- **Code checker:** Flags lines that use removed or deprecated NEAR APIs.
- **Error explainer:** Matches pasted NEAR errors to a cause and a fix.
- **Live protocol state:** Reports protocol versions on mainnet and testnet.
- **Governance and forum:** Reads gov.near.org threads, proposals and incidents.
- **REST API too:** The same data is also served through a REST API.

## Good for

- Check whether a NEAR npm package is still maintained before using it
- Find what broke between two nearcore versions
- Paste a transaction failure and get the likely cause
- Verify generated NEAR code for removed APIs
- Follow House of Stake proposals and forum debate

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http near-pedia https://near-pedia.xyz/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://near-pedia.xyz/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "near-pedia": {
      "url": "https://near-pedia.xyz/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "near-pedia": {
      "type": "http",
      "url": "https://near-pedia.xyz/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "near-pedia": {
      "serverUrl": "https://near-pedia.xyz/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "near-pedia": {
      "type": "http",
      "url": "https://near-pedia.xyz/mcp"
    }
  }
}
```

## Tools

- `search`: Keyword search over the NEAR knowledge base.
- `get_doc`: Read the full text of one indexed NEAR documentation page.
- `semantic_search`: Meaning-based search over NEAR docs and forum threads.
- `find_code_examples`: NEAR code examples on a topic, each checked first.
- `get_breaking_changes`: Changes between two versions of a NEAR product.
- `find_known_issues`: Surface unresolved problems matching a description.
- `check_deprecation`: Check whether a NEAR package, method or service is deprecated.
- `resolve_package`: Look up a NEAR npm or crates.io package version.
- `explain_error`: Explain a pasted NEAR error and its fix.
- `get_standard`: Fetch a NEAR standard (NEP) by number.
- `check_code`: Check NEAR code for removed or deprecated usage.
- `get_protocol_status`: Live protocol state of mainnet and testnet.
- `get_discussion`: Read a gov.near.org forum thread in full.

## FAQ

### Do I need a key?

No. The endpoint at near-pedia.xyz/mcp needs no authentication and exposes no write tools.

### Where does the data come from?

docs.near.org, NEAR GitHub organizations, npm and crates.io, gov.near.org and NEAR RPC.

### What happens if NEAR RPC is down?

Protocol and validator tools serve their last snapshot, marked stale.

### Which clients are covered?

Claude, ChatGPT connectors, Claude Desktop, Cursor, VS Code, Windsurf, Cline, Continue, Zed and others.

### Is NEARpedia free?

Yes. NEARpedia is free to use.

### How do I add NEARpedia to Claude Code?

Run this command in your terminal: claude mcp add --transport http near-pedia https://near-pedia.xyz/mcp

### What are the best alternatives to NEARpedia?

The closest alternatives to NEARpedia are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/nearpedia
