Log inSubmit server
Novai MCP Server logo

Novai MCP Server

by 0x-devc

Read-only MCP access to NOVAI blockchain blocks, transactions, AI entities, signals, oracle anchors, balances, and memory objects.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Novai MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "0x-devc-novai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "novai-mcp-server"
      ],
      "env": {
        "NOVAI_RPC_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 12 tools correctly (1mo ago).

Overview

The 0x-devc/novai-mcp-server MCP server exposes read-only queries for the live NOVAI blockchain through standard MCP tools. It forwards validated requests to NOVAI's public JSON-RPC endpoint and returns typed chain data without signing, submitting, or handling keys. Use it when an MCP-equipped agent needs to inspect blocks, transactions, AI entities, balances, signals, oracle anchors, or entity-owned memory objects. Node.js 18 or newer is required, and the server communicates with clients over stdio.

Use cases

  • Inspect the current NOVAI chain tip
  • Query confirmed transactions and account balances
  • Analyze signal commitments by issuer or type
  • Review oracle anchors and entity memory objects

Key features

  • Read-only NOVAI JSON-RPC access
  • Block and transaction lookup
  • AI entity and balance queries
  • Signal commitment filtering
  • Oracle anchor and memory object retrieval
  • Stdio MCP transport

Tools12

What Novai MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.9k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

8/9 checks healthy over the last 87d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · novai-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads135Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed12Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Novai MCP Server works

What 0x-devc/novai-mcp-server MCP server does

The 0x-devc/novai-mcp-server MCP server gives MCP clients query access to the live NOVAI chain, an AI-native layer 1 using chained-BFT consensus. It is designed as a thin bridge between an agent and NOVAI's public JSON-RPC API, so an agent can inspect blockchain state without writing a custom SDK integration.

The available data includes the latest chain tip, individual blocks, confirmed transactions, account or entity balances, and on-chain AI entity records. Agents can also inspect signal commitments, oracle anchors, and memory objects associated with NOVAI entities. The package intentionally excludes write, signing, transaction-submission, and private-key functionality.

How it works

After the MCP client starts the process, the server advertises its query tools through MCP over standard input and output. Each tool maps to a read operation on the configured JSON-RPC endpoint. Inputs are validated before a network request is made; chain-side errors and transport failures are returned as tool errors without stack traces.

Block queries can use either a height or a hash, but not both. The chain-status query is useful as a first call because it returns the current tip height and confirms that the chain is advancing. Height-based block access is limited by the node's retained recent window, while hash lookups can work for blocks still indexed by the node.

Hashes and identifiers use 64 hexadecimal characters without a 0x prefix, and block heights are non-negative integers. Balances are represented as decimal strings to preserve precision.

Setup and configuration

The 0x-devc/novai-mcp-server MCP server requires Node.js 18 or later. It can be started directly with npx or installed from npm before running its binary. For a stdio client configuration, use the package command as the MCP server process.

By default, requests go to https://rpc.novai.network. Set NOVAI_RPC_URL to use another JSON-RPC endpoint. No secret, token, or additional configuration is required because the documented endpoint is public and the server is read-only.

For local development, the repository documents npm install, npm run build, and npm test. The live endpoint test is available through npm run test:live, and an end-to-end stdio check can be run after building with node scripts/smoke.mjs.

Tools and capabilities

The 0x-devc/novai-mcp-server MCP server exposes tools for:

  • Reading the latest committed block's height, hash, round, transaction count, state root, and parent hash.
  • Fetching a block by height or hash and a confirmed transaction by transaction ID.
  • Looking up an AI entity, including its creator, code hash, autonomy mode, capability bits, balances, reputation, and activity data.
  • Reading an address or entity balance and nonce.
  • Listing signal commitments by block height, issuer, or signal type. Supported type codes cover anomaly, optimization, prediction, risk score, audit report, spam risk, and congestion forecast.
  • Fetching oracle anchors by signal hash, issuer, or data tag, with optional external timestamp filters for list queries.
  • Listing memory objects owned by an entity, including their type, heights, owner, identifier, and hex-encoded data.

Limitations and notes

This 0x-devc/novai-mcp-server MCP server cannot modify chain state. It does not hold private keys, sign requests, or submit transactions. Unknown transactions, entities, oracle anchors, and unavailable blocks may return null rather than an error. In particular, an old block height may no longer be available even if that block was valid, because the endpoint keeps only a bounded recent height window. Use a block hash when the node still indexes the historical block.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Novai MCP Server

Run `npx novai-mcp-server`, or install it with `npm install novai-mcp-server` and run `novai-mcp-server`. Node.js 18 or newer is required.

The material says the server works with any MCP-equipped agent and communicates over stdio, but it does not name Claude Desktop specifically.

No. It uses the public NOVAI JSON-RPC endpoint and requires no secrets, authentication, or other credentials.

No. It is read-only and has no write, signing, transaction-submission, or key-handling path.

Set the `NOVAI_RPC_URL` environment variable. If it is not set, the server uses `https://rpc.novai.network`.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNovai MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/0x-devc-novai-mcp-server?style=directory)](https://allmcps.com/mcp/0x-devc-novai-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/0x-devc-novai-mcp-server"><img src="https://allmcps.com/api/badge/0x-devc-novai-mcp-server?style=directory" alt="Novai MCP Server on AllMCPs" /></a>