# List Item Token Counter AI Agent Connect

> Analyze the token cost and structural efficiency of Markdown lists.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_aeIxJTr9vVDueJalgPU65M5piXai0bQfx1mPa5qe/ai-agent-connect
- **Tags:** markdown, tokens, optimization, text-analysis, efficiency

## Description

This MCP server provides specialized tools to measure the token consumption and structural overhead of Markdown-style lists. Use `analyze_list_structure` to get a detailed breakdown of item counts, token estimates, and optimization suggestions. You can also use `get_list_efficiency_summary` to determine if a list's formatting is wasting tokens, or `validate_list_syntax` to ensure your text follows standard list markers.

## Tools

### analyze_list_structure
Provides a detailed breakdown of the token metrics and structural costs for a given block of text containing list items

### get_list_efficiency_summary
Answers whether a list structure is efficient or wasting too many tokens on formatting

### validate_list_syntax
Validates if the text follows expected list formatting rules for detection

## Prompt Examples

**Prompt:** 
```
Analyze the token cost of this list: 
- Item 1
- Item 2
- Item 3
```

**Response:** 
```
The list contains 3 items with a total of 21 characters. The estimated token count is 5.25, with a bullet overhead of 1.5 tokens.
```

**Prompt:** 
```
Is this list structure efficient? 
* A
* B
* C
```

**Response:** 
```
The efficiency ratio is high, and the structural overhead is low for this 3-item list.
```

**Prompt:** 
```
Check if this text has valid list syntax: 1. First item, 2. Second item
```

**Response:** 
```
Yes, the text contains 2 validly formatted list items.
```

## Frequently Asked Questions

**How does this tool calculate token usage?**
The tool estimates token consumption based on a character-to-token ratio and adds a specific overhead for each list marker used.

**What is considered a 'Heavy List'?**
A list with more than 20 items is classified as a Heavy List, suggesting it might be more efficient to group or summarize the content.

**Can I use this with Cursor or Claude Desktop?**
Yes, this MCP server can be connected to Cursor, Claude Desktop, VS Code, Windsurf, and any other MCP-compatible client via Vinkius Edge.