# Vocabulary Total is your word tracker. AI Agent Connect

> Vocabulary Total acts as a central hub for your language acquisition. Instead of losing track of words across different study sessions, you can consolidate them into a single master list. Your AI client can record new terms, summarize specific study periods, or pull your entire English word bank whenever you need to review.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_M7wF9yeZBeJCpjMkUml6t4Vx2TM5sPY8tQZtHCTe/ai-agent-connect
- **Tags:** vocabulary, english, learning, study, aggregation

## Description

Stop losing track of the words you learn during different study sessions. Vocabulary Total gives your AI client a way to build and manage a persistent master list of English vocabulary. When you encounter new terms in a reading exercise or a conversation, your agent can immediately log them. You don't have to manually maintain a spreadsheet or a notebook; the MCP handles the aggregation for you.

You can use this to see exactly how much your vocabulary is growing over time. By grouping words into specific sessions, you can review what you learned on a particular day or look at your total progress across every session you've ever completed. It turns your AI client into a long-term memory for your language studies, making it easy to track mastery levels and ensure you aren't just seeing the same words repeatedly without actually learning them.

## Tools

### add_session_vocabulary
This tool adds a set of English words from a specific learning session to your master list.

### get_mastery_statistics
This tool analyzes how your vocabulary is distributed across different mastery levels.

### get_session_summary
This tool retrieves a summary of the vocabulary you learned during a specific session.

### get_total_vocabulary
This tool provides your complete, aggregated list of all English vocabulary from every session.

## Prompt Examples

**Prompt:** 
```
Add these words from my session 'session_123': 'serendipity' (noun, a fortunate accident) and 'ephemeral' (adjective, lasting a short time). Mark them as new.
```

**Response:** 
```
Successfully added 2 words from session 'session_123'. Total vocabulary count is now 45.
```

**Prompt:** 
```
What is the summary for session 'session_123'?
```

**Response:** 
```
Session 'session_123' contains 2 words: serendipity (noun) and ephemeral (adjective).
```

**Prompt:** 
```
Show me all the nouns I have learned.
```

**Response:** 
```
You have learned 12 nouns: serendipity, ocean, mountain, and 9 others.
```

## Capabilities

### Session Logging
Your agent records new words immediately after a study session.

### Vocabulary Aggregation
The MCP combines words from every individual session into one master list.

### Progress Tracking
Your agent checks mastery statistics to see how well you know certain words.

### Session Review
Your agent pulls summaries of specific past learning sessions.

### Master List Access
Your agent retrieves your entire English word bank on command.

## Use Cases

### Daily Study Logging
After reading an English article, tell your agent to add the new words to today's session.

### Mastery Audits
Ask your agent for mastery statistics to see which words need more practice.

### Session Recap
Request a summary of a specific session to review what you learned yesterday.

### Vocabulary Auditing
Pull your total vocabulary list to see the full scope of your English word bank.

## Benefits

- Consolidates fragmented study notes into one central repository.
- Automates the recording of new terms during active learning.
- Provides a clear view of vocabulary mastery through statistical distribution.
- Eliminates the need for manual word lists or external spreadsheets.

## How It Works

Connecting this MCP to your AI client gives it the ability to manage your word lists directly.

1. Connect the Vocabulary Total MCP to your preferred AI client through Vinkius.
2. Tell your agent to add new words from your current study session.
3. Ask your agent to summarize or list words from previous sessions.
4. Review your overall progress using mastery statistics.

## Frequently Asked Questions

**How do I add new words to my list?**
You simply tell your AI client to use the add_session_vocabulary tool, providing the words and the session ID.

**Can I see all the words I have ever learned?**
Yes, you can ask your agent to use the get_total_vocabulary tool to see your entire aggregated English word bank.

**Does this work with Claude or Cursor?**
Yes, this MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**How does it track my progress?**
The MCP uses the get_mastery_statistics tool to analyze how your vocabulary is distributed across different mastery levels.

**Do I need to manage my own database?**
No, Vinkius hosts the MCP and manages the data, so you only need to connect your client once.

**How do I add new words?**
You can use the `add_session_vocabulary` tool to submit a list of words, their definitions, and their parts of speech from a specific session.

**Can I filter my vocabulary list?**
Yes, the `get_total_vocabulary` tool allows you to filter your master list by part of speech or by a specific search term.

**How is mastery tracked?**
Mastery is tracked via the verdict assigned during word entry. You can view the distribution of your words using `getMasteryStatistics`.