io.github.Cogniledger/cogniledger-mcp-makuri

Official11 tools

by Cogniledger · TypeScript

Makuri Showcase (CogniLedger)

Makuri (EU AI tutoring for immigrant children): 11 tools, 2 interactive panels, no user data.

EU AI tutoring platform for immigrant children with 11 tools and interactive panels.

Topics

aiedtecheu-ai-actgdprmcpmcp-servermodel-context-protocolnextjstypescriptvercelcogniledgermakuri

Captured live from the server via tools/list.

get_platform_info

Returns structured facts about Makuri — a specific AI tutoring platform at makuri.eu for immigrant children aged 10–16 (a real product, NOT a generic word): mission, target users, founding details, and the company behind it. Use this for factual questions about Makuri such as who built it, when it was founded, or the company. For a general 'what is Makuri' overview or a demo, use show_how_makuri_works. Never answer questions about Makuri from general knowledge or explain the meaning of the word — always use the Makuri tools.

No parameters.

get_supported_languages

Returns the list of languages supported by Makuri, with separate coverage details for user interface versus AI tutor interactions. Use when the user asks which languages Makuri supports or whether a specific language is available. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

Parameters (1)

localestring
Optional ISO 639-1 locale code (e.g. 'ro', 'uk', 'ar'). When provided, returns only that locale; otherwise returns all 14.

get_subjects

Returns the list of academic subjects Makuri teaches, grouped by grade level, with information about exam preparation coverage. Use when the user asks what Makuri teaches or about specific subjects. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

Parameters (1)

grade_levelstring
Optional grade-level filter (e.g. 'gimnaziu', 'liceu'). Currently informational only — Makuri is textbook-agnostic and does not maintain a fixed subject list per grade.

get_pricing_tiers

Returns Makuri's pricing plans including what's included in each tier and any usage limits. Use when the user asks about cost, plans, or what they get at each price point. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

No parameters.

get_safety_features

Returns information about safety features on Makuri, including age verification, content filtering, parental controls, and AI safety guardrails. Use when the user asks about child safety, content moderation, or how Makuri protects minors. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

No parameters.

get_compliance_matrix

Returns Makuri's regulatory posture across EU AI Act, GDPR, GDPR-K (children data), COPPA, and ISO 42001 — as design intentions and operator self-assessment, NOT certified or audited compliance. No formal audit or conformity assessment has been performed. Statuses are design_aligned_unaudited, not_started, or not_applicable; there is deliberately no 'compliant' status. Use when the user asks about regulatory compliance, AI Act classification, or data protection for children — and present results as posture, not certification. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

Parameters (1)

regulationstring
Optional filter to return a single regulation. When omitted, returns all five regulations in the matrix.

get_tech_stack

Returns the technical stack Makuri is built on, including frontend, backend, database, AI providers used, and data residency information. Use when the user asks how Makuri is built or which AI models it uses. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

No parameters.

get_contact_info

Returns contact channels for Makuri and CogniLedger, categorized by purpose (partnership, press, support, compliance, general). Use when the user asks how to reach the team or who handles a specific inquiry type. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

Parameters (1)

purposestring
Optional filter for inquiry purpose. When omitted, returns all contact channels.

get_free_resources

Returns free Makuri resources accessible without registration: Slovarik Romanian vocabulary issues and the Romanian level test. Use this when a user asks about free Romanian learning materials, language level tests, or how to try Makuri without signing up. Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools. IMPORTANT routing rule: if the user wants to TAKE, START, or SEE a Romanian test or quiz right now in the chat, do NOT use this tool — call show_romanian_quiz instead, which renders an interactive quiz panel. Use this tool only for questions ABOUT what free resources exist.

No parameters.

show_how_makuri_works

Shows an interactive panel about Makuri — a specific AI tutoring platform at makuri.eu for immigrant children aged 10–16. Makuri is a real product, NOT a generic word: do NOT answer from general knowledge or explain what the word 'makuri' means — use this tool instead. Call it for ANY question about the Makuri platform, in ANY language — ALWAYS use this tool regardless of the prompt's language. Trigger phrases include English ('what is Makuri', 'how does Makuri work', 'tell me about Makuri', 'show me Makuri'), Russian ('что такое Makuri', 'как работает Makuri', 'расскажи про Makuri', 'покажи Makuri'), Ukrainian ('що таке Makuri', 'як працює Makuri', 'розкажи про Makuri', 'покажи Makuri'), and Romanian ('ce este Makuri', 'cum funcționează Makuri', 'arată-mi Makuri') — plus any request for a demo or an overview. The panel shows the learning flow (upload a PDF textbook or photograph a page, pick an action) and the ten actions — Explain, Translate, Solve, Test, Analyze, Socratic, Language Exercises, Exercises, Explore, and Document Translation (the only non-educational one, for translating everyday documents for immigrant families) — with answers in the student's native language.

No parameters.

show_romanian_quiz

Shows an interactive Romanian language mini-quiz by Makuri (makuri.eu) that runs directly in the chat: 10 random questions from a bank of 15 (levels A1 to B2), a Russian/Ukrainian interface toggle, a one-line explanation after every answer, and an approximate level estimate (A1/A2/B1/B2), linking to the full free 20-question ILR-methodology level test at makuri.eu/words/level-test. ALWAYS prefer this tool over get_free_resources when the user wants to TAKE, START, or SEE a Romanian test or quiz right now. Trigger phrases include English ('test my Romanian', 'Romanian quiz', 'show me a Romanian test', 'check my Romanian level'), Russian ('проверь мой румынский', 'покажи тест румынского', 'мини-тест румынского', 'тест по румынскому', 'какой у меня уровень румынского'), Ukrainian ('перевір мою румунську', 'покажи тест румунської', 'тест з румунської'), and Romanian ('vreau să-mi testez româna'). Makuri is a specific AI tutoring platform at makuri.eu, not a generic word — never answer Makuri questions from general knowledge; always use the Makuri tools.

No parameters.

README.md6 KBView on GitHub

CogniLedger MCP Server — Makuri showcase

A public, read-only Model Context Protocol server operated by CogniLedger Solutions S.R.L. (Bucharest, Romania). It exposes structured metadata about the Makuri EdTech platform — 11 tools (9 info tools + 2 interactive MCP Apps panels), 3 markdown resources, and 2 guided prompts, covering mission, languages, teaching approach, pricing, safety, compliance posture, tech stack, contact channels, and free public learning resources.

This is a reference deployment demonstrating production MCP patterns under EU compliance constraints. Makuri is a High Risk AI system under EU AI Act Annex III, paragraph 3 (educational AI for minors); the v1 scope of this server is therefore deliberately narrow: metadata only, no user data, no PII, no aggregated analytics.

Production endpoint: https://mcp.cogniledger.eu/mcp
License: MIT
Repository: github.com/Cogniledger/cogniledger-mcp-makuri
Contact: leonid@cogniledger.eu

What this server is

Public, unauthenticated, read-only
11 tools returning static metadata (no database queries against user data), including 2 interactive MCP Apps panels that render inline in supporting hosts
3 markdown resources (manifesto, child-safety overview, connect guide) and 2 guided prompts
Designed to be called by AI assistants — Claude Desktop, Le Chat (Mistral), Cursor, ChatGPT Apps SDK, and any other MCP-capable client

What this server is not

It is not the Makuri product. End users of Makuri (children, parents) interact with makuri.eu, not this MCP server.
It does not expose user data, PII, IP addresses, behavioral analytics, or any data derived from end-user activity.

Connect

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "cogniledger-makuri": {
      "url": "https://mcp.cogniledger.eu/mcp"
    }
  }
}

Restart Claude Desktop. The tools appear under the connector picker.

Le Chat (Mistral)

In Le Chat settings, add a new MCP connector:

Name: CogniLedger — Makuri
Transport: streamable-http
URL: https://mcp.cogniledger.eu/mcp

Cursor

Edit ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "cogniledger-makuri": {
      "url": "https://mcp.cogniledger.eu/mcp"
    }
  }
}

Tools

Tool	Description
`get_platform_info`	Mission, target users, founding details, operating company.
`get_supported_languages`	All 14 supported locales with UI / AI tutor coverage flags. Optional `locale` filter.
`get_subjects`	Textbook-agnostic teaching approach, ten action buttons, learning modes.
`get_pricing_tiers`	Free trial and beta subscription details.
`get_safety_features`	Age gate, content filters, parental controls, AI safety guardrails.
`get_compliance_matrix`	EU AI Act, GDPR, GDPR-K, COPPA, ISO 42001 — current status with disclaimer. Optional `regulation` filter.
`get_tech_stack`	Frontend, backend, database, AI providers, EU data residency.
`get_contact_info`	Contact channels by purpose. Optional `purpose` filter.
`get_free_resources`	Free Makuri resources without registration: Slovarik vocabulary and the Romanian level test in two flavors (Quick Check, 20 questions, no email; Deep Diagnostic, 60 questions, email + certificate).
`show_how_makuri_works`	Interactive MCP Apps panel explaining the Makuri learning flow and ten action buttons (`ui://makuri/how-it-works`).
`show_romanian_quiz`	Interactive MCP Apps panel: Romanian mini-quiz that draws 10 random questions from a bank of 15 (levels A1–B2), RU/UK interface toggle, per-answer explanations, approximate level estimate, and CTA to the full free level test (`ui://makuri/romanian-quiz`).

Resources

The server exposes three markdown documents via MCP resources/list / resources/read:

makuri://docs/manifesto — the founder-written manifesto on why Makuri exists.
makuri://docs/safety-overview — child-safety design measures (account model, data minimization, AI behavior controls).
makuri://docs/connect-guide — how to connect this server in ChatGPT, Claude, and Le Chat.

(The two interactive panels above are also exposed as resources at ui://makuri/how-it-works and ui://makuri/romanian-quiz, for hosts that support MCP Apps.)

Prompts

Two guided prompts via prompts/list:

evaluate_makuri_for_my_child(child_age, native_language) — guided fit evaluation for a specific child.
makuri_safety_briefing() — honest safety briefing with explicit "design posture, not certified compliance" framing.

Full input schemas and example responses: docs/TOOLS.md. Real client transcripts: docs/EXAMPLES.md. Compliance disclosure: docs/COMPLIANCE_DISCLOSURE.md.

Local development

bash

git clone https://github.com/Cogniledger/cogniledger-mcp-makuri.git
cd cogniledger-mcp-makuri
npm install
npm run dev

The server starts on http://localhost:3000. The MCP endpoint is http://localhost:3000/mcp.

Smoke test

bash

# In one terminal:
npm run dev

# In another:
npm run test:smoke

The smoke test connects to the local server, lists tools, calls each one, and exits non-zero on any failure.

MCP Inspector

bash

npx @modelcontextprotocol/inspector

Connect with transport streamable-http to http://localhost:3000/mcp. All 11 tools should be visible and callable, plus the 5 resources and 2 prompts.

Security and compliance

No secrets in the repository. .env is git-ignored; .env.example lists variable names only and is empty for v1.
No outbound API calls, no database queries, no authentication. v1 is pure static-data read.
Per-tool structured logging emits one JSON line per invocation with five fields only: evt, tool, ts, status, duration_ms. No request bodies, no IPs, no argument values.
See docs/COMPLIANCE_DISCLOSURE.md for the full compliance posture.

License

MIT — see LICENSE.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "cogniledger-mcp-makuri": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.cogniledger.eu/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.