English Français العربية

io.github.0x-devc/novai-mcp-server

Registre officiel Finance et paiements

Read-only MCP server for querying the live NOVAI blockchain over its public JSON-RPC endpoint.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package novai-mcp-server
Claude Code 
claude mcp add novai-mcp-server -- npx -y novai-mcp-server@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "novai-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "novai-mcp-server@0.1.1"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. NOVAI MCP server
  2. Safety boundary
  3. Requirements
  4. Install and run
  5. Configuration
  6. Tools
  7. Development
  8. License

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.

ToolReturnsRequired paramsOptional params
novai_get_chain_statusThe latest committed block, so you can verify the chain is live and learn the tip heightnonenone
novai_get_blockA single blockexactly one of height or hashnone
novai_get_transactionA confirmed transaction, or null if unknowntxidnone
novai_get_ai_entityAn AI entity (agent) record, or null if unknownentity_idnone
novai_get_balanceBalance (decimal string) and nonce for an addressaddressnone
novai_get_signals_by_heightSignal commitments recorded at a heightheightnone
novai_get_signals_by_issuerSignals issued by an entity within a height rangeissuer, start_height, end_heightnone
novai_get_signals_by_typeSignals of a type within a height rangesignal_type, start_height, end_heightnone
novai_get_oracle_anchorAn oracle anchor by signal hash, or null if unknownsignal_hashnone
novai_get_oracle_anchors_by_entityOracle anchors by issuer within a height rangeentity_id, start_height, end_heightts_min, ts_max
novai_get_oracle_anchors_by_tagOracle anchors by data tag within a height rangedata_tag, start_height, end_heightts_min, ts_max
novai_get_memory_objectsOn-chain memory objects owned by an entityentity_idnone
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.

Questions fréquentes

Qu'est-ce que io.github.0x-devc/novai-mcp-server ?

Read-only MCP server for querying the live NOVAI blockchain over its public JSON-RPC endpoint.

Comment installer io.github.0x-devc/novai-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add novai-mcp-server -- npx -y novai-mcp-server@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.0x-devc/novai-mcp-server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.0x-devc/novai-mcp-server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.0x-devc/novai-mcp-server ?

Il est publié par 0x-devc. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.