# io.github.aaronmsoto/tokenomics-overview-mcp (npm · tokenomics-overview-mcp)

Unofficial MCP server for AI tokenomics: Big-T notation, cache metrics, levers, FOCUS 1.5 AI.

- Trust score: 87/100 (high trust)
- Change this week: +7
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `tokenomics-overview-mcp`: 87/100 (this document), [markdown](https://verifymcp.io/servers/aaronmsoto-tokenomics-overview-mcp/tokenomics-overview-mcp.md), [page](https://verifymcp.io/servers/aaronmsoto-tokenomics-overview-mcp/tokenomics-overview-mcp)

## Channel facts

- Registry: `npm`
- Package: `tokenomics-overview-mcp`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to aaronmsoto/finops-framework-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 15 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 77/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 3489 tokens (~33/item across 103 items; 20 tools + 83 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 53/100
  - Stability observed for 16 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 79/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 25% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 20 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 22 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the io.github.aaronmsoto/tokenomics-overview-mcp server?

io.github.aaronmsoto/tokenomics-overview-mcp runs locally as an npm package, launched with npx -y tokenomics-overview-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add aaronmsoto-tokenomics-overview-mcp -- npx -y tokenomics-overview-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "aaronmsoto-tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "aaronmsoto-tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add aaronmsoto-tokenomics-overview-mcp -- npx -y tokenomics-overview-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "aaronmsoto-tokenomics-overview-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "tokenomics-overview-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add aaronmsoto-tokenomics-overview-mcp --command npx --arg -y --arg tokenomics-overview-mcp
```

### Hermes

```yaml
mcp_servers:
  aaronmsoto-tokenomics-overview-mcp:
    command: "npx"
    args: ["-y", "tokenomics-overview-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "aaronmsoto-tokenomics-overview-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add aaronmsoto-tokenomics-overview-mcp -t stdio -c npx -a -y tokenomics-overview-mcp
```

### Other

```json
{
  "mcpServers": {
    "aaronmsoto-tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-04 (score 87, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 86, +6)

- [functional improvement] Stability: unverified → 0.47

### 2026-10-21 (score 80, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-20 (score 65)

First indexed and scored.

## MCP tools (20)

### `get_tokenomics_info` (~39 tokens)

Tokenomics server overview

Start here. Data version, entity counts, and every source document with its publication status (Working Draft, Release Candidate, …). No parameters.

Output parameters:

- `counts` (object)
- `crawled_at` (string)
- `curriculum_loaded` (boolean)
- `data_version` (string)
- `documents` (array)
- `experimental` (boolean)
- `start_here` (array)

### `list_documents` (~51 tokens)

List Tokenomics Foundation source documents

Every ingested tokeneconomics.com document with kind (docs/project/paper/insight), publication status, and section ids for get_document. Optional `kind` filter.

Input parameters:

- `kind` (string)

Output parameters:

- `documents` (array)

### `get_document` (~96 tokens)

Get a source document (or one section)

Canonical markdown of one Tokenomics Foundation document, prefixed with its publication status and followed by CC BY attribution. Pass `section` (an id from list_documents) to get one section instead of the whole document — prefer this for long papers and podcast transcripts.

Input parameters:

- `document` (string, required): Document slug, e.g. 'cache-explainer'
- `section` (string): Section id, e.g. 'tcmonitoring'

Output parameters:

- `document` (object)
- `section`

### `list_layers` (~85 tokens)

List the Seven-Layer Tokenomics Stack

The seven layers (L0 Energy … L5 AI access and control, the routing/gateway layer … L6 Demand and entry points) with the published summary: whether each moves the Big-T multiplier, its key metric, and its primary levers. The lower three set what a token costs; the middle three move a workload between Big-T classes; the top layer sets demand.

Output parameters:

- `layers` (array)
- `status` (string)

### `get_layer` (~99 tokens)

Get one stack layer

One layer of the Seven-Layer Stack: description, components, published tooling table, and the levers that sit at it. `layer` accepts 'l5', '5', 'L5', the layer name ('ai access and control'), or its first word ('energy', 'demand'). L5 is the proxy / router / gateway layer.

Input parameters:

- `layer` (string, required): e.g. 'l3' or 'inference stack'

Output parameters:

- `layer` (object)
- `levers` (array)

### `get_bigt_notation` (~77 tokens)

Big-T notation (T-notation) overview

Big-T notation, 'Big-O for AI consumption': T(n · k · a) = requests × model calls per request × agent depth, and the six-class complexity ladder from T(1) to T(∞), each with its published fix. Use it to classify how a workload's token cost grows before optimizing constants.

Output parameters:

- `classes` (array)
- `expansion` (string)
- `notation` (string)
- `status` (string)
- `variables` (array)

### `get_bigt_class` (~102 tokens)

Get one Big-T complexity class

One rung of the Big-T ladder: what puts a workload in it, the published fix, the stack layers whose levers move it, and the levers tagged with it. `class` accepts 'T(n·k)', 'n*k', 'nk', 'multiplicative', or a slug like 't-n-k'.

Input parameters:

- `class` (string, required): e.g. 'T(n·k·a)' or 'agent-multiplicative'

Output parameters:

- `class` (object)
- `levers` (array)
- `moved_by_layers` (array)

### `list_levers` (~154 tokens)

List consumption and efficiency levers

Optimization levers as the Foundation publishes them: the stack's primary levers per layer (caching, batching, right-sizing, quantization, complexity routing, budgets, agent caps…), Big-T's five levers (routing, serialization, caching, abstraction transparency, governance), architectural approaches with published token reductions, and the 34× worked-example steps. Filter by `layer` (0-6), `bigt_class`, `kind`, or `document`.

Input parameters:

- `bigt_class` (string): e.g. 'T(n·k)'
- `cursor` (string)
- `document` (string)
- `kind` (string)
- `layer` (integer)
- `limit` (integer)

Output parameters:

- `levers` (array)
- `nextCursor` (string)
- `total` (number)

### `get_lever` (~39 tokens)

Get one lever

Full record for one optimization lever, with provenance and status. Look up by slug or name from list_levers.

Input parameters:

- `lever` (string, required)

Output parameters:

- `lever` (object)
- `uri` (string)

### `list_metrics` (~65 tokens)

List reference metrics

The Foundation's reference metrics with their published formulas: Cache Hit Rate, Cache Cost Efficiency and uncached equivalent cost (cache explainer), net benefit and risk expected loss (value classification), cost per token (definition), and AI unit economics (TCA over realized value, a proposal).

Output parameters:

- `metrics` (array)

### `get_metric` (~61 tokens)

Get one reference metric

One metric's published formula, definition, inputs, 'what good looks like' targets, and its cross-links to the FinOps Framework / FOCUS servers. E.g. 'cache-hit-rate', 'cache-cost-efficiency'.

Input parameters:

- `metric` (string, required)

Output parameters:

- `crosslinks` (array)
- `crosswalk` (array)
- `metric` (object)
- `uri` (string)

### `calculate_cache_metrics` (~253 tokens)

Calculate Cache Hit Rate and Cache Cost Efficiency

Applies the cache explainer's published formulas to YOUR token counts. Cache hit rate = cache read / (cache read + cache write + uncached input). Cache cost efficiency = 1 − actual prompt cost / uncached equivalent cost, where uncached equivalent cost = (cache read + cache write + uncached input) × base input price. Give token counts; add `base_input_price_per_mtok` plus either `actual_prompt_cost` or the read/write multipliers (e.g. 0.1 and 1.25) to also get cost efficiency. Compare per workload, not blended.

Input parameters:

- `actual_prompt_cost` (number): Actual billed prompt (input-side) cost, if known
- `base_input_price_per_mtok` (number): Base (uncached) input price per million tokens
- `cache_read_multiplier` (number): Cache read price as a multiple of base input, e.g. 0.1
- `cache_read_tokens` (number, required)
- `cache_write_multiplier` (number): Cache write price as a multiple of base input, e.g. 1.25
- `cache_write_tokens` (number, required)
- `uncached_input_tokens` (number, required)

Output parameters:

- `actual_prompt_cost` (number|null)
- `actual_prompt_cost_source` (string)
- `cache_cost_efficiency` (number|null)
- `cache_hit_rate` (number)
- `cache_write_to_read_ratio` (number|null)
- `formulas` (array)
- `interpretation` (string)
- `total_input_tokens` (number)
- `uncached_equivalent_cost` (number|null)

### `get_provider_cache_snapshot` (~77 tokens)

Provider prompt-cache behavior snapshot

The cache explainer's dated snapshot of frontier providers' prompt-cache pricing and behavior (write/read charges as multiples of base input, minimum cacheable prefix, lifetime). A snapshot, not a spec — verify against current provider docs. Optional `provider` filter (anthropic, openai, google).

Input parameters:

- `provider` (string)

Output parameters:

- `providers` (array)

### `list_personas` (~75 tokens)

List tokenomics personas

The eight core personas (Engineering, FinOps Practitioner, AI End User, Finance, Product, Procurement, Leadership, Capacity) and four allied ones, with the stages (Production, Consumption, Value) each spans. Filter by `stage` or `core`.

Input parameters:

- `core` (boolean)
- `stage` (string)

Output parameters:

- `personas` (array)
- `stages` (array)

### `get_persona` (~37 tokens)

Get one persona

One persona's responsibilities, key decisions, signals and metrics, and stated links to FinOps Framework capabilities.

Input parameters:

- `persona` (string, required)

Output parameters:

- `crosslinks` (array)
- `crosswalk` (array)
- `persona` (object)
- `uri` (string)

### `list_value_categories` (~58 tokens)

Value classification: outcome categories and booking destinations

The ten outcome categories (direct dollar wins, labor, intangible) with 'estimate as' units, and the five destinations Finance books realized value to. From 'Classifying and Measuring Realized Value from AI'.

Input parameters:

- `group` (string)

Output parameters:

- `booking_destinations` (array)
- `categories` (array)
- `status` (string)

### `define_term` (~60 tokens)

Define a tokenomics term

Glossary lookup across the Foundation's definition page and the cache explainer (e.g. 'KV cache', 'prompt cache', 'tokenmaxing', 'Jevons paradox'). Returns every matching definition with its source.

Input parameters:

- `term` (string, required)

Output parameters:

- `curriculum_matches` (array)
- `matches` (array)

### `get_focus_ai_tracker` (~152 tokens)

FOCUS 1.5 AI-cost tracker

The Foundation's page on what FOCUS 1.5 does for AI cost, one card per capability: in the working draft (e.g. ModelId and other model properties on SKU Price Details, TokenCacheAction / TokenDirection, PrincipalId / CredentialId), in final Member review (SKU Price dataset, AI billing worked examples), and not in 1.5. Filter by `bucket` (done|review|out) or an `identifier` such as 'TokenCacheAction'. Nothing here is in a ratified FOCUS release until 1.5 is ratified; the FOCUS server serves ratified versions.

Input parameters:

- `bucket` (string)
- `identifier` (string)

Output parameters:

- `items` (array)
- `status` (string)

### `get_crosslinks` (~126 tokens)

Cross-links to the FinOps Framework and FOCUS servers

Stated links from tokenomics entities to the other two servers: each carries a quote from the Foundation page that names the target, and a finops://framework/… or focus://spec/… URI to read with those servers (null for FOCUS working-draft identifiers). Filter by `entity_type` + `slug` (e.g. metric cache-hit-rate) or by target `server`.

Input parameters:

- `cursor` (string)
- `entity_type` (string)
- `limit` (integer)
- `server` (string)
- `slug` (string)

Output parameters:

- `links` (array)
- `nextCursor` (string)
- `total` (number)

### `search_tokenomics` (~85 tokens)

Search tokenomics content

Ranked keyword search across layers, Big-T classes, levers, metrics, personas, value categories, glossary terms, FOCUS tracker items, and every document section. Use when you don't know the slug; follow up with the matching get_* tool or get_document(section).

Input parameters:

- `entity_types` (array)
- `limit` (integer)
- `query` (string, required)

Output parameters:

- `results` (array)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/aaronmsoto-tokenomics-overview-mcp/tokenomics-overview-mcp#diagnostics

## Score history

- 2026-11-05: 87
- 2026-11-04: 87
- 2026-11-03: 86
- 2026-11-02: 80
- 2026-11-01: 80
- 2026-10-31: 80
- 2026-10-30: 80
- 2026-10-29: 80
- 2026-10-28: 80
- 2026-10-27: 80
- 2026-10-26: 80
- 2026-10-25: 80
- 2026-10-24: 80
- 2026-10-23: 80
- 2026-10-22: 80
- 2026-10-21: 80
- 2026-10-20: 65

## Common questions

### What is the io.github.aaronmsoto/tokenomics-overview-mcp server?

io.github.aaronmsoto/tokenomics-overview-mcp is listed in the public MCP registry as io.github.aaronmsoto/tokenomics-overview-mcp. Unofficial MCP server for AI tokenomics: Big-T notation, cache metrics, levers, FOCUS 1.5 AI. This page covers its npm package (tokenomics-overview-mcp).

### Is the io.github.aaronmsoto/tokenomics-overview-mcp server safe to use?

io.github.aaronmsoto/tokenomics-overview-mcp scores 87 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.aaronmsoto/tokenomics-overview-mcp server expose?

io.github.aaronmsoto/tokenomics-overview-mcp exposes 20 tools: get_tokenomics_info, list_documents, get_document, list_layers, get_layer, and 15 more. Their descriptions and schemas cost roughly 1,791 tokens of context every time the server is loaded.

### Is the io.github.aaronmsoto/tokenomics-overview-mcp server still maintained?

io.github.aaronmsoto/tokenomics-overview-mcp is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.aaronmsoto/tokenomics-overview-mcp server under?

io.github.aaronmsoto/tokenomics-overview-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/tokenomics-overview-mcp
- Socket report: https://socket.dev/npm/package/tokenomics-overview-mcp
- Repository: https://github.com/aaronmsoto/finops-framework-mcp
- Website: https://aaronmsoto.github.io/finops-framework-mcp/
- Changelog RSS feed: https://verifymcp.io/servers/aaronmsoto-tokenomics-overview-mcp/tokenomics-overview-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/aaronmsoto-tokenomics-overview-mcp/tokenomics-overview-mcp.json
- HTML version of this page: https://verifymcp.io/servers/aaronmsoto-tokenomics-overview-mcp/tokenomics-overview-mcp