# TON Developers

> Public, read-only TON mainnet console: https://tondevs.xyz
> Every number is what one full node sees — applied blocks, overlay, liteserver, live transaction bus.
> Not a price site, not an account explorer, not a validator how-to.

Live figures change every few seconds. Do not quote a TPS from this file.
Agents: use MCP. Humans: open the page.

## Views

- https://tondevs.xyz/  Overview
- https://tondevs.xyz/shards  Shards
- https://tondevs.xyz/overlay  Overlay traffic
- https://tondevs.xyz/validators  Validators
- https://tondevs.xyz/mcp  MCP connect
- https://tondevs.xyz/changelog  Changelog
- https://tondevs.xyz/upgrades  Upgrades
- https://tondevs.xyz/about  What the numbers are (this copy, as HTML)
- https://tondevs.xyz/messages  Messages processed vs Real TPS

Telegram: https://t.me/tondevs_tg
X: https://x.com/ton_devs

## MCP (preferred for agents)

Endpoint: https://mcp.tondevs.xyz/mcp

```
claude mcp add --transport http tondevs https://mcp.tondevs.xyz/mcp
codex mcp add tondevs --url https://mcp.tondevs.xyz/mcp
```

Cursor: `{"mcpServers":{"tondevs":{"url":"https://mcp.tondevs.xyz/mcp"}}}`

Tools: list_metrics, get_head, get_snapshot, get_health, get_series, what_moved, compare, render_chart, get_events, get_shards, get_collation, get_validators, get_producers, get_rotation, get_config, get_node_view

Workflow: list_metrics → get_snapshot or get_series → render_chart for a PNG.
Peak / what else moved: what_moved, then render_chart.

## Keys

- card:o:0  Messages processed /s — hops. A GRAM transfer is 2 of these. Explorers publish this. get_head.messages_processed_per_s is the same thing, not Real TPS.
- card:u:0  Real TPS — one count per user operation.
- topo:shards / get_shards  live shard count from this node's record. Fold by maximum.
- get_validators  countries, providers, sites. Geo of an ADNL is the latest scan.

Windows: 10m, 1h, 6h, 24h, 3d, 7d, 30d, 60d, 90d.

## JSON the page already uses

- GET https://tondevs.xyz/d?k=head
- GET https://tondevs.xyz/d?k=win&tf=3600
- GET https://tondevs.xyz/d?k=shards&tf=3600
- GET https://tondevs.xyz/cl/upgrades?limit=3
- GET https://tondevs.xyz/healthz

## Honesty

- One observer, not a global oracle.
- Holes stay holes. Birth-trim and gap-mask drop fake rate() ramps and thin scrapes.
- This node's stall 22 Aug 2026 04:48–05:43 UTC is dropped; the chain did not stall.
- Overlay before 5 Aug 2026 19:09 UTC is membership, not the network. Cut.
- Swap counts before 20 Aug 2026 20:56 UTC used a wrong opcode set (~10×). Cut.
- Messages processed, Real TPS, jetton, swap, NFT: measurement starts 21 Aug 2026 (bus classifier).
- Block rate and masterchain interval: 22 Jul 2026 on this observer.
- WalletTg census: 27 Aug 2026 13:40 UTC (JetStream here).
- created_by in a block header is the leader window, not necessarily the collator.
- Split cause only when collation_stats reported that minute. Otherwise not observable.
- get_node_view is this machine. Do not treat its sync lag as network health.

## This site does not have

- Token price, market cap, exchange rates
- DeFi TVL or DEX market volume as a statistic
- Step-by-step validator setup
- Arbitrary account / transaction explorer search (there is a live message feed on Overview, not a lookup box)

## Questions this site can answer

Q: What is TON TPS right now?
A: Call get_head or get_snapshot. Say whether you mean hops (card:o:0 / get_head) or Real TPS (card:u:0).

Q: How many shards are live?
A: Overview / Shards, or get_shards. This node's record, not a third-party index.

Q: How many validators, where are they?
A: Validators view or get_validators. Country/provider of a past cycle is where that ADNL is today.

Q: What upgraded on TON recently?
A: Changelog / Upgrades on the site, or GET /cl/upgrades.

Q: Why did TPS move?
A: MCP what_moved on card:o:0 or card:u:0, then render_chart. Do not invent a cause.

Q: What is the Gram price?
A: Not on this site.