# Dialogue Ratio Calculator AI Agent Connect

> Dialogue Ratio Calculator MCP helps authors and editors measure the balance of spoken words against narration. You can use it to find specific dialogue segments, check if a chapter is too dialogue-heavy, and validate your quotation marks to ensure accurate text parsing.

## Overview
- **Category:** writing
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_BKQdyGOtmzihaezkNic9iVRjtsdw3jxB48JCPPWg/ai-agent-connect
- **Tags:** manuscript, dialogue, editing, text-analysis, authors

## Description

Writing a balanced story is hard. You might feel like your characters talk too much or that your narration is dragging, but guessing isn't helpful. This MCP gives you the hard numbers. By plugging your manuscript into your AI client, you can instantly see the ratio of dialogue to narration. You can define your own quotation marks or delimiters to make sure the math is right. It's a technical way to handle a creative problem. Instead of squinting at pages to see if a scene feels heavy on speech, you just ask your agent for the percentage. It works by identifying spoken segments based on your specific punctuation rules and then calculating the word count distribution. This lets you make data-driven decisions about your pacing and character interaction without manual counting.

## Tools

### find_dialogue_segments
This tool locates all spoken parts within your text. It identifies specific segments of dialogue based on your defined delimiters.

### get_manuscript_summary
This tool provides a high-level overview of your text. It helps you quickly determine if a passage is dialogue-heavy.

### validate_delimiter_pairs
This tool checks your quotation marks or custom delimiters. It ensures your parsing characters are logically sound before you run an analysis.

### analyze_manuscript_text
This tool calculates the exact percentage of dialogue versus narration. It uses your custom delimiters to split the text and count the words.

## Prompt Examples

**Prompt:** 
```
Analyze this text: He said, "Hello!" She replied, "Hi there." How much is the dialogue ratio?
```

**Response:** 
```
The dialogue ratio is 50%. There are 4 dialogue words and 4 narration words.
```

**Prompt:** 
```
Is this text dialogue-heavy? Text: "Wait!" he shouted. "No way!" she yelled.
```

**Response:** 
```
Yes, the text is dialogue-heavy as the dialogue makes up more than half of the total word count.
```

**Prompt:** 
```
Find all the dialogue segments in: The cat sat. 'Meow,' said the cat. 'Purr,' it added.
```

**Response:** 
```
The dialogue segments are: 'Meow' (1 word) and 'Purr' (1 word).
```

## Capabilities

### Ratio Calculation
Your agent calculates the exact percentage of spoken words compared to narration.

### Segment Identification
The MCP finds every instance of dialogue in a block of text.

### Pacing Checks
Your agent uses manuscript summaries to flag if a scene is too heavy on dialogue.

### Delimiter Validation
The tool verifies that your quotation marks are correctly paired for accurate parsing.

## Use Cases

### Pacing Analysis
Check if a chapter is moving too fast by seeing if the dialogue ratio is too high.

### Character Voice Checks
Use segment identification to see how much a specific character actually speaks.

### Formatting Verification
Run delimiter validation to make sure your quotation marks are correctly placed.

### Manuscript Summarization
Get a quick summary to see if a scene is dialogue-heavy before doing a deep dive.

## Benefits

- Removes the guesswork from measuring dialogue density.
- Provides exact word counts for spoken vs. narrated text.
- Works with custom quotation marks to fit different writing styles.
- Identifies specific dialogue locations instantly.

## How It Works

You connect the MCP to your AI client and start analyzing text immediately.

1. Connect your preferred client like Claude or Cursor to Vinkius.
2. Provide the text you want to analyze to your agent.
3. Define your quotation marks or delimiters if they are non-standard.
4. Run the analysis tool to get your dialogue and narration percentages.

## Frequently Asked Questions

**How does the MCP calculate the dialogue ratio?**
It uses your specified quotation delimiters to separate spoken words from narration and then compares the word counts.

**Can I use custom quotation marks?**
Yes, you can specify custom delimiters to ensure the tool parses your specific writing style correctly.

**What clients can I use this with?**
You can use this MCP with any compatible client, including Claude, Cursor, Windsurf, and VS Code.

**Will this help me find where characters are talking?**
Yes, the find_dialogue_segments tool is designed to locate specific spoken parts in your text.

**How do I know if my quotation marks are correct?**
You can use the validate_delimiter_pairs tool to check that your parsing characters are logically sound.

**How do I define my quotation marks?**
You provide the specific characters used as start and end delimiters in the tool inputs. For example, use double quotes (") for standard English text.

**Can I use non-standard symbols for dialogue?**
Yes, as long as the delimiters are distinct and follow an alternating pattern, you can use any character or string to mark dialogue.

**What is considered a 'word' in the analysis?**
A word is defined as any sequence of characters separated by whitespace.