playto / Docs / MCP Guide

AI Assistant (MCP) Guide

Connect Claude to your Playto learning data for personalized study advice, glossary building, and learning analysis.

Pro feature. The AI Assistant (MCP) is available in the Pro version ($9.99 on Steam).

What is MCP?

MCP (Model Context Protocol) is a way for AI assistants like Claude to securely connect to your local applications. Think of it as giving Claude a window into your Playto data — your vocabulary, translation history, game profiles, and learning stats.

With MCP, Claude can read your data (but never modify it without your permission), answer questions about your learning progress, help you build glossaries, and suggest study strategies based on your actual usage.

Everything stays local. Your data is not uploaded anywhere — Claude connects to Playto's MCP server running on your own PC.

Playto doesn't need to be running. The MCP server reads directly from your local database, so you can use Claude to analyze your learning data anytime — even when you're not gaming.

Connecting Claude Desktop

1

Install Claude Desktop

Download and install Claude Desktop from Anthropic if you haven't already.

2

Copy MCP Config from Playto

In Playto, go to Settings > MCP. Click the Copy Config button. This copies the JSON configuration to your clipboard.

3

Add to Claude Desktop Config

Open Claude Desktop's settings file at:

%APPDATA%\Claude\claude_desktop_config.json

Paste the copied config inside the "mcpServers" object. It should look like:

{
  "mcpServers": {
    "playto": {
      "command": "node",
      "args": ["C:\\...\\playto\\mcp\\index.js"]
    }
  }
}
4

Restart Claude Desktop

Restart Claude Desktop. You should see a Playto icon in the MCP tools section, confirming the connection is active.

What Claude Can Access

Resource Description
wordsYour saved vocabulary (recent 500)
sentencesTranslated sentences (recent 500)
logTranslation history (recent 200)
packsAll game profiles / packs
statsPlayer stats and counts
questsDaily quest state
badgesEarned badges and achievements

Available Tools

  • search_words — Search vocabulary by word, definition, or context
  • search_log — Search translation history
  • get_glossary — Look up per-game glossary terms
  • update_word — Edit word definitions (with your permission)
  • delete_word — Remove words (with your permission)

Use Cases

Glossary Building

Ask Claude to organize your vocabulary by category (characters, locations, items, skills) and help build a comprehensive game-specific glossary.

Learning Analysis

Get insights into your learning patterns — which words you struggle with, your quiz accuracy trends, and suggestions for what to focus on next.

Data Maintenance

Ask Claude to find and fix duplicate entries, clean up definitions, or batch-update words with better translations.

Study Planning

Get personalized study plans based on your vocabulary coverage, daily quest completion, and learning streaks.

Example Prompts

Copy these prompts and paste them into Claude Desktop to get started.

Show me my learning stats and suggest what I should focus on today.
Search my vocabulary for words I've gotten wrong more than 3 times. Help me understand why I struggle with them.
Look at my recent translations and create a categorized glossary for the game I'm currently playing.
Check my word list for any duplicates or entries with missing definitions, and help me clean them up.
What's my vocabulary coverage for each game? Which game would benefit most from more study?

Troubleshooting

Claude doesn't show the Playto MCP tool

  • Double-check the file path in claude_desktop_config.json. Use double backslashes (\\) on Windows.
  • Make sure the JSON is valid — a missing comma or bracket will silently fail.
  • Fully restart Claude Desktop (not just close the window — quit from the system tray).

Error: "node" is not recognized

Node.js is required to run the MCP server. Install it from nodejs.org (LTS version recommended). After installing, restart Claude Desktop.

MCP connects but returns no data

  • Make sure you've used Playto at least once to create the database.
  • Playto does not need to be running — MCP reads the database directly.
  • Check that the path in your config points to the correct Playto installation directory.

Firewall or antivirus blocking

The MCP server communicates locally via stdio (not network). If your antivirus flags it, add an exception for the mcp/index.js file. No internet access is required.

Getting Started FAQ