Canton Mcp

io.github.Noves-IncPublished by GitHub account Noves-Incv0.2.3Updated Oct 24, 2026

Query Canton Network balances, rewards, transactions, prices, and identity from any AI agent.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A read-only MCP server that lets an AI assistant query Canton Network data through the Noves API: balances, rewards, transactions, CC prices and the network/org

What you can do
Resolve parties and browse the network directory by name, ANS name or raw party ID, including super validators and org types. Look up current or historical balances and daily balance history for a party. Retrieve reward summaries, per-day totals and individual payouts. List classified transaction history, transfer statistics and full payloads of single updates. Query CC spot and historical prices, including hourly or daily OHLC.
When to use it
Useful when you want an assistant to answer questions about Canton Network activity, such as a party's balance trend, rewards, transaction history, validator directory or CC price movement, without leaving the chat. It is read-only, so it suits analysis and reporting rather than acting on the network.
Requirements
Runs locally as an npm package via npx, so Node.js is needed. Requires a Noves API key supplied as the NOVES_API_KEY environment variable, the --api-key flag, or a saved config file created by the init command. Network access to the Noves Canton API is required. Desktop MCP clients only.
Before you install
The NOVES_API_KEY credential is required; the README says it is sent only to the Noves Canton API and never logged, and that the one-click desktop install stores it in the OS keychain. The server is described as read-only and cannot change network or account data. Queries and party identifiers are sent to a third-party API, and free-tier rate limits apply.

Installation

In SourceWeft

  1. Open Canton Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Noves]

canton-mcp

Ask your AI about the Canton Network.

[npm version] [CI] [MCP Registry] [MIT license]

An MCP server for the Noves Canton API — balances, rewards, classified transactions, CC prices, identity, and the network directory, queryable from Claude Code, Claude Desktop, Cursor, or any MCP-capable agent.

text
You: How has the CC price moved over the last 7 days? Chart it.AI:  → get_price(startDate, endDate, interval: "daily")     CC closed at $0.1462 today, up 4.2% on the week (low $0.1402, high $0.1521).     [renders an interactive price chart]

Quick start

Get your free API key at https://app.noves.fi/register/free.

Claude Desktop — one click

Download canton-mcp.mcpb from the latest release, double-click it (or drag into Claude Desktop), and paste your API key in the settings form that appears. The key is stored in your OS keychain. Done.

Claude Code

bash
npx -y @noves/canton-mcp init   # one-time: prompts for your key, validates it, saves itclaude mcp add canton -- npx -y @noves/canton-mcp

Or in one line, passing the key explicitly:

bash
claude mcp add canton --env NOVES_API_KEY=<your-key> -- npx -y @noves/canton-mcp

Cursor / other MCP clients

After npx -y @noves/canton-mcp init, no env var is needed:

json
{  "mcpServers": {    "canton": {      "command": "npx",      "args": ["-y", "@noves/canton-mcp"]    }  }}

(Or skip init and add "env": { "NOVES_API_KEY": "<your-key>" }.)

Key resolution order: NOVES_API_KEY env var → --api-key flag → ~/.config/canton-mcp/config.json. The key is sent only to api.canton.noves.fi and never logged.

Tools

Every tool that takes a party accepts an ANS name, a display name, or a raw party ID (name::hash) — resolution is automatic, and ambiguous names return a candidate list to choose from.

Examples:

  • "Who are the super validators on Canton?" → search_directory(orgType: "sv")
  • "What's Noves' current CC balance?" → get_balance(party: "noves.unverified.cns")
  • "Chart Noves' balance over the last 30 days." → get_balance_history(party, startDate, endDate)
  • "Show recent traffic purchases for this validator." → get_transactions(party, txType: "buyTraffic")
ToolWhat it answers
resolve_party"Who is this party?" — canonical party ID, org type, balance, ANS names
search_directory"Who are the super validators?" — browse/filter the network directory
get_balance"What's this party's balance?" — current or at any point in time (date)
get_balance_history"Chart its balance over last month" — daily end-of-day snapshots
get_rewards"What did it earn?" — summary metrics, per-day totals, or individual payouts
get_transactions"Show its recent traffic purchases" — classified history (transfer, buyTraffic, …)
get_transfer_stats"How active is it?" — counts, volumes, unique counterparties
get_price"CC price trend this month?" — spot, historical spot, hourly/daily OHLC
get_transactionFull classified payload of one update by ID

See examples/PROMPTS.md for questions to try.

Notes & limits

  • Read-only. The server only reads data; it can't change anything on the network or in your account.
  • Date inputs accept ISO dates (2026-06-01), ISO datetimes, or unix timestamps.
  • Daily rewards are fetched in ≤30-day windows upstream; the server merges up to 90 days per call.
  • List outputs are capped (default 25 rows) with hasMore hints to keep agent context lean.
  • get_transactions returns 25 rows by default and accepts limit up to 100; use includeCount for the total count in a date window, and get_transaction for one full update.
  • Chains/txTypes (1h), directory & identity lookups (5m), and spot price (60s) are cached in-process, keeping typical agent sessions comfortably inside the free tier.

License

MIT © Noves Inc.

Source: README.md at commit 93d2ccc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts