How do I install Novai?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Novai need an API key?

No required environment variable is listed on this record.

When was Novai last checked?

Last checked 2026-11-08. Read-only MCP server for querying the live NOVAI blockchain over its public JSON-RPC endpoint.

Novai MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.0x-devc-novai-mcp-server -- npx -y novai-mcp-server@0.1.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.0x-devc-novai-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

NOVAI MCP server

A read-only Model Context Protocol (MCP) server that lets any MCP-equipped agent query the live NOVAI chain over its public JSON-RPC endpoint. It exposes query tools only. There is no write, sign, submit, or key-handling path anywhere in this package.

NOVAI is an AI-native layer 1 with chained-BFT consensus. This server is a thin, typed bridge: an agent discovers the tools through standard MCP tooling and reads the chain without writing any SDK code.

Safety boundary

This is version 0 and it is read-only by design.

Every tool is a query that maps to a single read method on the public endpoint.
The package never holds a private key, never signs, and never submits a transaction.
The write methods the chain exposes are deliberately not wired in.

Requirements

Node.js 18 or newer.

Install and run

Run it directly with npx:

npx novai-mcp-server

Or install it and run the binary:

npm install novai-mcp-server
novai-mcp-server

The server speaks MCP over stdio. Point your MCP client at the command above.

Example MCP client configuration

{
  "mcpServers": {
    "novai": {
      "command": "npx",
      "args": ["novai-mcp-server"]
    }
  }
}

Configuration

NOVAI_RPC_URL overrides the JSON-RPC endpoint. It defaults to the public NOVAI URL, https://rpc.novai.network. No other configuration, no secrets, and no auth are required, because the public endpoint is open and read-only.

Tools

All hashes and ids are 64 hex characters (32 bytes, no 0x prefix). All heights are non-negative integers. Every input is validated before any network call, and both chain errors and transport failures are returned as clean tool errors with no stack traces.

Tool	Returns	Required params	Optional params
`novai_get_chain_status`	The latest committed block, so you can verify the chain is live and learn the tip height	none	none
`novai_get_block`	A single block	exactly one of `height` or `hash`	none
`novai_get_transaction`	A confirmed transaction, or null if unknown	`txid`	none
`novai_get_ai_entity`	An AI entity (agent) record, or null if unknown	`entity_id`	none
`novai_get_balance`	Balance (decimal string) and nonce for an address	`address`	none
`novai_get_signals_by_height`	Signal commitments recorded at a height	`height`	none
`novai_get_signals_by_issuer`	Signals issued by an entity within a height range	`issuer`, `start_height`, `end_height`	none
`novai_get_signals_by_type`	Signals of a type within a height range	`signal_type`, `start_height`, `end_height`	none
`novai_get_oracle_anchor`	An oracle anchor by signal hash, or null if unknown	`signal_hash`	none
`novai_get_oracle_anchors_by_entity`	Oracle anchors by issuer within a height range	`entity_id`, `start_height`, `end_height`	`ts_min`, `ts_max`
`novai_get_oracle_anchors_by_tag`	Oracle anchors by data tag within a height range	`data_tag`, `start_height`, `end_height`	`ts_min`, `ts_max`

A note on block lookups by height

The endpoint retains a bounded recent window of blocks by height, so a height far below the current tip can return null even though it was a valid block. Lookups by hash work for any block the node still indexes. Call novai_get_chain_status first to learn the current tip height.

Development

npm install
npm run build
npm test

npm test runs the offline unit and validation tests. To exercise the live endpoint:

npm run test:live

An end-to-end stdio check that spawns the built server and drives it with a real MCP client is available:

npm run build && node scripts/smoke.mjs

License

MIT. See the LICENSE file.

Novai

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Novai?

Does Novai need an API key?

What transport does Novai use?

When was Novai last checked?

Documentation

NOVAI MCP server

Safety boundary

Requirements

Install and run

Example MCP client configuration

Configuration

Tools

A note on block lookups by height

Development

License