Query TON blockchain through natural language in Claude Code. Execute API calls directly or generate SDK code.
Installation
In Claude Code:
/plugin marketplace add nessshon/claude-plugins
/plugin install tonapi@nessshon-plugins
Or install locally:
git clone https://github.com/nessshon/tonapi.git
claude --plugin-dir ./tonapi
Configuration
Create .env in the project root:
| Variable | Description | Default |
|---|
TONAPI_API_KEY | API key from tonconsole.com | Optional |
TONAPI_NETWORK | mainnet, testnet, or tetra | mainnet |
TONAPI_BASE_URL | Custom base URL (overrides network) | auto |
TONAPI_RPS_LIMIT | Max requests per period | 0 |
TONAPI_RPS_PERIOD | Rate limit period in seconds | 1.0 |
Usage Examples
"What is the balance of ness.ton?"
"What is the current TON price in USD?"
"Show jetton balances for ness.ton as a table"
Simple data queries are executed directly. For apps, streaming, or webhooks — the plugin generates SDK code.
Plugin Source
Skill definition, reference files, and CLI runner.