# Tools

{% hint style="info" %}
Tools are available to both humans (via the dashboard) and AI agents (via MCP / REST API with x402 payment). Nova Premium subscribers get unlimited access to all tools.
{% endhint %}

***

### Available Tools — 18 Total

#### Paid Tools

| Tool                     | Slug               | Price    | Description                                                                                    |
| ------------------------ | ------------------ | -------- | ---------------------------------------------------------------------------------------------- |
| **Deep Token Analytics** | `token-analytics`  | 500 sats | AI-generated report: price, market data, holder distribution, trading volume, on-chain metrics |
| **Contract Scanner**     | `contract-scanner` | 500 sats | AI-powered Clarity security audit: vulnerabilities, access control, asset flows, risk ratings  |

#### Free Tools — Analytics

| Tool                    | Slug               | Description                                                                                       |
| ----------------------- | ------------------ | ------------------------------------------------------------------------------------------------- |
| **Token Price**         | `token-price`      | Real-time price, market cap, 24h volume, liquidity, and holder count for any Stacks token         |
| **Wallet Lookup**       | `wallet-lookup`    | STX balance, token holdings, and trading P\&L for any Stacks address                              |
| **Token Holders**       | `token-holders`    | Holder distribution: top wallets, concentration %, supply breakdown, per-holder USD values        |
| **Whale Watch**         | `whale-watch`      | Large trades on Stacks DEXes: big buys/sells, net flows, whale sentiment by timeframe             |
| **Market Overview**     | `market-overview`  | Stacks DeFi dashboard: total TVL, 24h volume, active traders, top gainers/losers, trending pools  |
| **DeFi Pools**          | `defi-pools`       | Liquidity pools across DEXes: filter by token, sort by TVL/volume/APY, compare reserves and yield |
| **Address Activity**    | `address-activity` | Decoded tx history: transfers, contract calls, deployments, stacking ops with descriptions        |
| **Transaction Decoder** | `tx-decoder`       | Decode any Stacks tx: amounts in STX, function args, events, status, error diagnosis              |
| **BNS Resolver**        | `bns-resolver`     | Resolve Stacks address to BNS identity: primary name, all names, namespace, zonefile profile      |

#### Free Tools — Network & Bitcoin

| Tool                | Slug              | Description                                                                           |
| ------------------- | ----------------- | ------------------------------------------------------------------------------------- |
| **Stacks Network**  | `stx-network`     | Block height, PoX stacking cycle, mempool stats, and server version in one view       |
| **Stacking Info**   | `stacking-info`   | PoX cycle details: total STX staked, min threshold, top signers, next cycle countdown |
| **Bitcoin Fees**    | `btc-fees`        | Mempool fee rates with cost estimates for typical tx sizes and congestion assessment  |
| **Bitcoin Address** | `bitcoin-address` | BTC balance, tx count, Ordinals, BRC-20, Runes, Sats Names. Legacy/SegWit/Taproot     |

#### Free Tools — Other

| Tool                    | Slug              | Description                                                                                     |
| ----------------------- | ----------------- | ----------------------------------------------------------------------------------------------- |
| **Contract Reader**     | `contract-reader` | Clarity contract explorer: functions, variables, token definitions, inline read-only calls      |
| **Stacks Daily Digest** | `stacks-digest`   | Daily ecosystem digest: dev updates, DeFi activity, community highlights. Generated at 9 AM UTC |

***

### For Humans

1. Go to [Nova Tools](https://nova.zeroauthoritydao.com/tools)
2. Select a tool and fill in the input form
3. **Premium users**: Click "Run Tool" — results appear immediately
4. **Non-premium users**: Click "Run Tool" — select a payment method (STX, sBTC, or USDCx), approve in your wallet, and results appear after payment

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>Payment uses the x402 protocol with a two-phase flow. If tool execution fails after payment verification, your wallet is <strong>never charged</strong>.</p></div>

   \*\*\*

### For AI Agents

Nova tools are accessible to AI agents via two methods:

1. **MCP Server** — `npx @nova/mcp-server` or connect to `https://nova.zeroauthoritydao.com/mcp`
2. **REST API** — `POST /api/tools/:slug/run` with x402 inline payment
3. **Discovery** — `GET /.well-known/agent.json` for machine-readable tool catalog

All 18 tools are auto-discovered by MCP clients with full input schemas and pricing.

See the dedicated guides:

***

### Pricing

| Access Level                     | Paid Tools           | Free Tools         |
| -------------------------------- | -------------------- | ------------------ |
| **Nova Premium**                 | Free, unlimited      | Free, unlimited    |
| **Dashboard user** (non-premium) | x402 payment per use | Free, rate-limited |
| **AI agent** (Stacks address)    | x402 payment per use | Free, rate-limited |

**Rate limits for free tools:** 5 calls/min, 30 calls/hour per IP.

**Accepted payment tokens**: STX, sBTC, USDCx — all on Stacks mainnet.

{% hint style="info" %}
Get [Nova Premium](https://nova.zeroauthoritydao.com/premium) for unlimited access to all current and future tools.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zeroauthority.xyz/nova-bot/tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.