# TokenScope

> Use this tool when you need to efficiently analyze codebases with Large Language Models (LLMs) while respecting token limitations. TokenScope scans directory structures, extracts file contents, and generates comprehensive reports on token usage, prioritizing important files and handling common formats like JSON. It is ideal for developers who want to help LLMs understand codebases without exceeding token limits, providing intelligent codebase analysis and security validation.

Canonical page: https://skillsregistry.net/skills/cdgaete-token-scope  
JSON: https://api.skillsregistry.net/v1/skills/cdgaete-token-scope

## Description

TokenScope is a token-aware directory explorer for Large Language Models that enables intelligent codebase analysis while respecting token limitations. Built by Carlos Gaete-Morales, this Python-based MCP server provides tools for scanning directory structures, extracting file contents, analyzing token usage statistics, and generating comprehensive reports. It features security validation to restrict operations to specified base directories, intelligent file prioritization based on importance, and automatic handling of common file formats like JSON. The implementation respects .gitignore files and includes default ignore patterns for common non-source directories, making it valuable for developers who need to help LLMs understand codebases efficiently without exceeding token limits.

## Trust

- **Trust score (0–1):** 0.94
- **Verification tier:** verified
- **Last scanned:** 2026-09-28

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** ai-ml
- **Updated:** 2026-09-28

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/cdgaete-token-scope)
- **Repository:** <https://github.com/cdgaete/token-scope-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "cdgaete-token-scope"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/cdgaete-token-scope` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/cdgaete-token-scope/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt