> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenomist.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools & prompts

> The 16 read-only tokenomics tools the Tokenomist server exposes, suggested workflows, and example prompts to kickstart your build.

The tokenomics tools below are **read-only** and safe to call automatically — 16 of them today. The server also exposes 8 **write** tools for submitting a token to Tokenomist's self-listing platform; see [Self-listing](/mcp/self-listing) for those.

## MCP tools

| Tool                          | Purpose                                                                                  |
| ----------------------------- | ---------------------------------------------------------------------------------------- |
| `token_list`                  | List tokens with price, supply, and market cap. Supports search, sort, and pagination.   |
| `token_info`                  | Full tokenomics for a single token by ID — supply, vesting, fundraising, burn/buyback.   |
| `search_token`                | Search by name, symbol, or slug — returns matching token IDs and slugs.                  |
| `unlock_event_list`           | Past + upcoming unlock (cliff) events for a specific token.                              |
| `unlock_event_overview`       | Cross-token unlock view, grouped by token, with rich filters.                            |
| `upcoming_unlock_events`      | The next upcoming unlock per token (one event per token), with the same filters.         |
| `emission`                    | Weekly emission schedule for a token — amounts, values, and allocation breakdowns.       |
| `daily_emission`              | Daily emission schedule for a token — same shape, day-level granularity.                 |
| `token_allocation`            | Standard allocation breakdown (Team, Investors, Ecosystem…) with locked/unlocked totals. |
| `fundraising_investor_list`   | All crypto investors and VCs with their funding round participation.                     |
| `fundraising_investor_detail` | Funding rounds for a specific investor, filterable by date, amount, or lead status.      |
| `fundraising_token`           | A token's fundraising history — rounds, valuations, prices, and participating investors. |
| `burn_token_list`             | All tokens that have burn events.                                                        |
| `burn_token_detail`           | Burn event history for a specific token — dates, amounts, burner addresses, reasons.     |
| `buyback_token_list`          | All tokens that have buyback programs.                                                   |
| `buyback_token_detail`        | Buyback event history for a specific token — dates, amounts, spent values, addresses.    |

## Suggested workflows

* **Find a token, then drill in** — `search_token` → `token_info`, `token_allocation`, or `fundraising_token`.
* **Scan upcoming supply pressure** — `upcoming_unlock_events` with `minMarketCap` + `minValueToMarketCap` filters.
* **Investor research** — `fundraising_investor_list` → `fundraising_investor_detail` for a specific VC.
* **Deflationary analysis** — `burn_token_list` → `burn_token_detail` (paired with `buyback_token_detail`) for net inflation.
* **Emission projections** — `emission` for weekly, `daily_emission` for day-level precision.

## Example prompts

Tap into the full potential of Tokenomist data — use these prompts to kickstart your next AI build.

### Simple queries

* What is Arbitrum's circulating supply and market cap?
* Search for tokens matching "pyth".
* What's the next upcoming token unlock for Aptos?
* Which tokens have active buyback programs?
* How much of SUI's supply is currently locked?

### Advanced queries

* Show me the next 30 days of unlocks across all tokens above \$100M market cap, where the unlock value is more than 1% of market cap. Display as an interactive table sorted by unlock date.
* Generate a stacked-bar chart of Arbitrum's weekly emissions for the next 12 weeks, broken down by allocation category (Team, Investors, Ecosystem, etc.).
* List every Series A funding round Paradigm participated in during 2025, with raise amount and valuation.
* Compare Bitcoin and Ethereum's total burn amounts and chart cumulative burns over time.

### Creative ideas

* Build a "token unlock cliff calendar" that highlights the 10 biggest upcoming unlocks by USD value.
* Generate a tokenomics "report card" for any token I type — supply distribution, unlock pressure, fundraising history, and burn/buyback activity.
* Build a "find me a similar token" tool: given a token, surface 5 others with comparable allocation structure and fundraising profile.