Lexicon MCP server
Fixes the names and jargon speech-to-text gets wrong before your agent acts on a dictated prompt.
1 stars263 downloads/wk
Reviews
Write oneNobody has reviewed Lexicon yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Lexicon tools (19, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_packInstall one starter pack from list_packs into the global lexicon (or the project .lexicon.yaml with scope: project).
add_termTeach the lexicon a name, so dictation is corrected to it from now on.
apply_suggestionApply a suggestion returned by suggest_terms after the user accepted it: 'alias' merges the alias into the term, 'term' adds the term (aliases auto-suggested when none given),
export_lexiconExport the merged lexicon in a format for another tool: 'claude-md' (markdown for CLAUDE.md / system prompts), 'markdown', 'text', 'wispr', 'superwhisper', 'whisper-prompt', 'openai', 'macos', 'espanso', 'deepgram', 'assemblyai', 'azure', 'google', 'csv', or raw 'json'.
harvest_repoScan a repository for proper nouns an STT engine is likely to mangle: package and dependency names, git authors, README brands, the project directory.
import_dictionaryImport a dictionary the user already has (Wispr Flow CSV, Superwhisper JSON, macOS Text Replacement plist, espanso YAML, plain text 'Canonical: alias1, alias2', generic CSV, or a lexicon JSON/YAML) into the lexicon.
install_clientRegister the lexicon MCP server (and, for Claude Code, its hooks) in an agent client's config: claude, codex, cursor, windsurf, gemini, vscode or claude-desktop.
learn_correctionRecord that the user corrected a spelling: they meant `meant`, but the transcript or you wrote `heard`.
lexicon_doctorAnswers "is lexicon set up for this user, and what is the one command that fixes it" in a single call.
lexicon_statsCounts of terms and aliases, total hits, the most-used terms, terms that never fired, and a per-file breakdown of the merged lexicon.
list_packsList the starter packs shipped with the lexicon (developer, ai, business, voice-tools: curated names with the misspellings STT produces for them) and which are already installed.
list_termsList the user's lexicon terms, global and project merged. Optional case-insensitive substring filter over canonical
normalize_transcriptFix the proper nouns speech-to-text got wrong, using this user's personal lexicon of names, brands, acronyms and identifiers.
remove_termwrite actionDelete a term from the user's lexicon by canonical spelling (case-insensitive).
serve_statusCheck whether the local lexicon API (`lexicon serve`, used by the browser extension, Claude Desktop, Shortcuts and the menu bar app) is running on 127.0.0.1:41733.
setup_lexiconOne-shot onboarding: seed the lexicon with the user's company and name, register the MCP server and hooks in their agent clients, optionally harvest the repo and install the local API as a login service.
suggest_canonicalLook up what a garbled word was probably meant to be.
suggest_termsPropose new aliases, terms and never-words from the user's voice history, usage and repo.
trust_projectManage trust for a repo's .lexicon.yaml, which is merged only after the user approves it (it can inject text into every session).
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan202 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
Install Lexicon in Claude Code, Cursor or VS Code
Runs npx -y @ashlr/lexicon on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add lexicon -- npx -y @ashlr/lexicon
What the publisher says
From the Lexicon repository's README, as published. We do not edit it. Read it on GitHub
Lexicon
A personal lexicon for voice-to-agents.
One YAML file of the words speech-to-text gets wrong, applied everywhere your voice lands: MCP, Claude Code, the browser, macOS.
Live demo · Quickstart · Docs · lexicon.ashlr.ai
You said: "tell Ashlr.AI to deploy the Kubernetes auth service"
STT heard: "tell Ashler to deploy the Cooper Nettie's off service"
Agent received: "tell Ashlr.AI to deploy the Kubernetes auth service"That is the live demo running this repo's real matcher on your text, in your browser, with nothing installed. (Its Dictate button uses your browser's own speech recognizer, which in Chrome sends audio to Google.)
Measured
Method, full tables and every failing case are in docs/BENCHMARK.md. Reproduce with npm run bench (no setup beyond a clone), or npm run bench:audio && npm run bench:compare (needs macOS and whisper.cpp).
Against the alternatives. 330 clips of real audio through whisper.cpp small.en, three voices. Same audio, same recognizer, same 70-term lexicon in every row; the only thing that changes is how the proper nouns get fixed.
Every row uses the same curated seventy-term lexicon (bench/lexicon.yaml). The prose column is a property of the terms in the file as much as of the matcher, so a lexicon assembled some other way is a different measurement.
Exact substitution recovers the spellings someone already wrote down, and nothing else. It cannot reach Versal, Superbase, CloudFloor or pedantic, because no table written by hand contains the mistake you have not heard yet. The phonetic and fuzzy tiers exist for that gap and recover 31 of the 279 term slots on their own, which is 11 points. The remaining 9 points over the casing-aware row come from the alias tier's tolerance for how the recognizer breaks a name into words, since that row already matches case. --prompt is a complement rather than a rival: stacked with the lexicon it reaches 95.7%.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Lexicon: common questions
- Is Lexicon MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the Lexicon safety report
- How do I install Lexicon?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Lexicon need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is Lexicon maintained?
- The last commit was 15 days ago (2026-09-28). The latest release is v0.5.4.
- What can I use instead of Lexicon?
- Servers from other publishers that do the same job: PaperBanana MCP server, Decionis MCP server and Agent-Native Analytics MCP server. Compare all Lexicon alternatives.
Alternatives to Lexicon
Same job from other publishers: the closest match first, then the best rated.
- PaperBananaGenerate academic diagrams and statistical plots from text using multi-agent AI.not reviewedEstablishedA
- DecionisAuthorize consequential AI agent actions before executionnot reviewedEstablishedA
- Agent-Native AnalyticsAgent-Native Amplitude/Mixpanel - connect data sources, prompt for chartsnot reviewedEstablishedA
- SuperlogOpen-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.not reviewedEstablishedA
- ImageAI image generation and editing with prompt optimization and quality presetsnot reviewedEstablishedB