MCP.Market

Lousa MCP server

by henriquepe·io.github.henriquepe/lousa·v0.1.1
No reviews yet

A whiteboard where AI agents draw their explanations as hand-drawn animated diagrams

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

full report

Adoption
New

0 stars28 downloads/wk

Reviews

Write one

Nobody has reviewed Lousa yet.

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

Lousa tools (6, 3 write)

write = sends, deletes, buys or posts

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

  • create_boardwrite action

    Creates a board (a hand-drawn visual explanation) on Lousa and returns {id, url}. Open/share the url with the user — the drawing animates in as if sketched live. …

  • delete_boardwrite action

    Deletes a board permanently.

  • get_board

    Reads a full board (title, narration, scene, requests, selection).

  • get_selection

    Returns what the user selected in the viewer (click toggles; Esc clears): {selection: ids, selectionAt, elements}. Use when the user references "what I selected" / "this part" — those elements are the target of the request. An old selectionAt may be residue from a previous request; when in doubt, confirm the target.

  • list_boards

    Lists existing boards (id, title, narration, element count, dates).

  • update_boardwrite action

    Updates an existing board. The scene you send REPLACES the current one entirely: keep unchanged elements byte-identical (same id and fields) — the viewer animates only what changed, live in the user's open tab; to remove an element, omit it. If the user's request references something they pointed at ("what I selected", "this part"), call get_selection first to learn the target.

Public scan report

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

no findings
  • Code scan10 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 53 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Lousa compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,255 servers
Tools
6
the typical server has 7
Tools that change things
50%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
28
more than 15% of 12,191 servers with a package

What its tools let an agent do: 3 read · 1 create · 1 change · 1 delete

Install Lousa in Claude Code, Cursor or VS Code

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

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

What the publisher says

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

Lousa

A whiteboard where your AI agent draws its explanations.

Ask your agent "explain this visually" and it sketches an animated, hand-drawn diagram on a live board — instead of another wall of text. Lousa is an MCP server + web viewer: the agent authors a declarative scene (boxes, arrows, cylinders, notes), and the board renders it stroke by stroke, as if someone were drawing it in front of you.

Lousa is Portuguese for the classic school blackboard.

Why it's different

  • The agent is the artist. No prompt box, no OCR — your coding agent already has the context and draws through typed MCP tools.
  • Live, incremental drawing. Follow-ups edit the scene; the open tab animates only what changed, like watching the diagram evolve.
  • Point at things. Click elements in the viewer to select them, then tell your agent "improve what I selected" — it reads your selection through get_selection and targets exactly that.
  • Boards expire by default (12h, sliding) — a whiteboard, not a document graveyard. ttlHours: 0 keeps a board forever.

Quick start

Requires Node.js 18.17+.

# Claude Code
claude mcp add lousa -- npx -y lousa mcp

# or run the server directly
npx lousa            # viewer at http://127.0.0.1:4666

Any MCP host works — for stdio configuration use command npx, args ["-y", "lousa", "mcp"]. The stdio endpoint auto-starts the local server, so the viewer is always available. Then ask your agent to "draw how our auth flow works" and open the URL it returns.

MCP tools

The scene is a JSON array of elements — box, ellipse, diamond, cylinder, arrow (connects ids), line, text, note — rendered with rough.js. The full schema ships inside the tool definitions; agents need no extra setup.

Self-hosting a shared server

Run lousa on any Node host and point machines at it:

LOUSA_TOKEN=<secret> HOST=0.0.0.0 npx lousa        # server
LOUSA_URL=https://your-host LOUSA_TOKEN=<secret> npx lousa mcp   # each client

LOUSATOKEN gates board listing/creation/deletion and /mcp; per-board URLs act as capability links. AWS Lambda + S3 deployment is supported out of the box (lambda.js handler + LOUSABUCKET for storage); any HTTPS front (API Gateway, etc.) works.

Development

npm install
npm test          # node --test
node cli.js       # local server

License

AGPL-3.0 © Henrique Pires

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

Lousa: common questions

Is Lousa MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Lousa safety report
How do I install Lousa?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Lousa need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Lousa maintained?
The last commit was 94 days ago (2026-08-02). The latest release is v0.1.1.
What can I use instead of Lousa?
Servers from other publishers that do the same job: draw.io MCP server.
How does Lousa compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Lousa

Same job from other publishers: the closest match first, then the best rated.

  • draw.io
    Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
    B