Mmcp.market

Vocabit MCP server

by JohnBilousov·io.github.JohnBilousov/vocabit-mcp·v0.1.3
No reviews yet

Create flashcard sets in the Vocabit app and read back how the learner actually did.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars37 downloads/wk

Reviews

Write one

Nobody has reviewed Vocabit yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Vocabit tools (8, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_study_setwrite action

    Build a flashcard set and publish it to the learner's Vocabit app. Returns a deep link that opens the set on their device. Prefer one focused topic and 8-15 cards per set — long sets get abandoned. Use the notes field for what you want to check afterwards; the learner never sees it.

  • delete_study_setwrite action

    Remove a set from the learner's app. Study history is kept on the backend, but the set disappears from their device. Ask before calling this.

  • get_set_results

    Read back real study results for a set: which cards the learner marked hard (weakCards), which they never reached (untouchedCards), and per-card review counts. This is the feedback half of the loop — read it before writing the next set, and build the follow-up out of weakCards.

  • get_study_set

    Read the full contents of a set — every card, plus the topic and notes you attached when you created it.

  • list_study_sets

    List the sets you created for this learner, newest first, each with a progress summary. Use it to find a setId, or to see at a glance which sets were never opened.

  • notify_learnerwrite action

    Send the learner a Telegram message that a set is waiting. Use sparingly — one ping per set, right after you create it.

  • update_study_setwrite action

    Change a set in place: retitle it, retag it, or add cards. Pass addCards to append (the usual case after reviewing results) or cards to replace the list wholesale — never both. Replacing the cards resets what the learner has already studied.

  • vocabit_health

    Verify the server can reach Vocabit and report which mode it is in (live backend or in-memory demo). Call this first if anything else fails.

Public scan report

scanner v0.1.9 · 2026-09-21 · same rubric, same numbers if you re-run it

no findings
  • Code scan17 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 qualitystatic API keys via environment variables6/15
  • Maintenancelast push 28 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the Vocabit repository's README, as published. We do not edit it. Read it on GitHub

vocabit-mcp

An MCP server for Vocabit, a flashcard app. It lets an AI assistant write a study set into a real app on a real phone, and then read back how the learner actually did with it.

Most MCP servers read from an API. This one closes a loop:

flowchart LR
    A["Assistant<br/>teaches a topic"] --> B["create_study_set"]
    B --> C["Set appears in the<br/>Vocabit app"]
    C --> D["Learner works<br/>through it"]
    D --> E["get_set_results"]
    E -->|weak cards| A

The interesting tool is not createstudyset — anything can generate flashcards. It is getsetresults: which cards the learner marked hard, which they never reached, how many reviews each one took. The next set is built out of that, not out of a guess.

Try it in 30 seconds

No backend, no account, no API key:

npx -y vocabit-mcp --demo

Demo mode runs the same server against an in-memory Vocabit with two seeded sets. Create a set, ask for results, and a deterministic stand-in learner will have worked through it — flagged in the response as simulated, so it is never mistaken for real data.

To poke at it with a UI:

npx @modelcontextprotocol/inspector npx -y vocabit-mcp --demo

Install

Listed in the MCP Registry as io.github.JohnBilousov/vocabit-mcp, so clients that read the registry can find it on their own.

Claude Code

claude mcp add vocabit -- npx -y vocabit-mcp

Claude Desktop / any MCP client

{
  "mcpServers": {
    "vocabit": {
      "command": "npx",
      "args": ["-y", "vocabit-mcp"],
      "env": {
        "VOCABIT_BASE_URL": "https://your-vocabit-backend.example.com",
        "VOCABIT_AGENT_KEY": "your-agent-key"
      }
    }
  }
}

Drop the env block to run in demo mode.

Tools

Also exposed: the vocabit://set/{setId} resource (a set as JSON, listable) and a study-session prompt that walks the whole loop.

Card states

Progress comes from the app's spaced-repetition engine, not from the assistant:

A set reports completed: true once no card is left in new.

Live mode

Point the server at a Vocabit backend that has the agent API enabled:

export VOCABIT_BASE_URL=https://your-vocabit-backend.example.com
export VOCABIT_AGENT_KEY=...   # must match one of AGENT_API_KEYS on the backend
npx -y vocabit-mcp

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y vocabit-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add vocabit-mcp -- npx -y vocabit-mcp
Add to Cursor

Vocabit: common questions

Is Vocabit MCP server safe?
Mostly: it is graded B (83/100). Read the Vocabit safety report
How do I install Vocabit?
It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Vocabit need an API key?
Yes. The registry entry asks for VOCABIT_AGENT_KEY.
Is Vocabit maintained?
The last commit was 28 days ago (2026-08-24). The latest release is v0.1.3.

More from JohnBilousov →