MCP.Market

Pixelletter MCP server

by bitterdev·io.github.bitterdev/pixelletter-mcp·v1.0.3
No reviews yet

Send physical letters and faxes through the PixelLetter interface, test mode included.

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

full report

Adoption
New

0 stars23 downloads/wk

Reviews

Write one

Nobody has reviewed Pixelletter yet.

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

Pixelletter tools (6, 4 write)

write = sends, deletes, buys or posts

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

  • cancel_orderwrite action

    Cancels a submitted order by its PixelLetter order id, which is on the order confirmation e-mail. Only works while the order has not been printed yet, otherwise PixelLetter answers with error 055.

  • get_account_info

    Reads the stored customer data and the current credit of the PixelLetter account. Use it before sending to make sure the balance covers the order, error 021 means the credit is too low.

  • get_interface_reference

    Returns what the PixelLetter interface documents: action values, dispatch centres, additional service codes, allowed upload types, limits and the published error codes. Offline lookup, no API call.

  • send_faxwrite action

    Sends documents or plain text as a fax through PixelLetter, without posting a letter. Additional services such as registered mail do not apply to faxes.

  • send_letterwrite action

    Sends a letter through PixelLetter, either as ready made documents (absolute file paths, PDF preferred) or as plain text plus a recipient address that PixelLetter typesets. Optionally faxes the same document as well. Returns the result code and the transaction id.

  • sign_invoicewrite action

    Sends documents to the PixelLetter invoice signing service (action 4) and optionally mails the signed PDF to the invoice recipient. The account needs electronic signatures enabled once in the customer area, otherwise PixelLetter answers with error 046.

Public scan report

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

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

How Pixelletter compares

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

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

What its tools let an agent do: 2 read · 1 change · 1 delete · 2 send or post

Install Pixelletter in Claude Code, Cursor or VS Code

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

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

What the publisher says

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

<!-- Author: Fabian Bitter (fabian@bitter.de) -->

pixelletter-mcp

Local MCP server (stdio) for the PixelLetter HTTPS interface. Hand it a PDF and a destination country and PixelLetter prints, folds, franks and posts the letter, optionally as registered mail. It also sends faxes, cancels orders, reads the account balance and drives the electronic invoice signature.

It pairs with pdf-letter-mcp: that server writes a DIN 5008 letter PDF, this one puts it in the post. sendletter takes the absolute path that createletter returns.

The implementation follows the published documentation: the HTTPS handbook, the e-mail handbook, the two signature handbooks, the reference PHP class (version 2.01) and the public error code list. Three values are not printed in those documents, colour printing, GoGreen postage and the NODUPLEX switch, and they are taken from the hudora/pyPostal client that has been sending real orders with them. They are marked as such in the table below. Nothing else is invented.

How the interface works

Everything is one multipart HTTPS POST to https://www.pixelletter.de/xml/index.php. The form field xml carries the order document, credentials included, and the fields uploadfile0, uploadfile1 and so on carry the documents. The answer is a small XML document: code 100 means the order was accepted, anything else is an error code from the published list. The final result, including whether the recipient address fitted the address window, arrives by e-mail a few hours later.

Test mode

Every sending tool needs an explicit testMode flag, there is no default. testMode: true runs the order exactly like a real one but PixelLetter never prints it, never sends it and never charges for it. testMode: false really posts the letter. Set PIXELLETTERFORCETEST_MODE=true to pin the whole server to test mode while wiring things up.

Install

npm install
npm run build

Register the server in Claude Code:

claude mcp add pixelletter \
  --env PIXELLETTER_EMAIL=you@example.com \
  --env PIXELLETTER_PASSWORD=your-password \
  -- node "/absolute/path/to/pixelletter-mcp/dist/src/index.js"

Or in ~/.claude.json / claudedesktopconfig.json:

{
  "mcpServers": {
    "pixelletter": {
      "command": "node",
      "args": ["/absolute/path/to/pixelletter-mcp/dist/src/index.js"],
      "env": {
        "PIXELLETTER_EMAIL": "you@example.com",
        "PIXELLETTER_PASSWORD": "your-password",
        "PIXELLETTER_DEFAULT_DESTINATION": "DE"
      }
    }
  }
}

Environment

Credentials are only read from the environment, nothing is stored in the repository and nothing is written to disk.

Tools

Shortened. The full README is on GitHub.

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

Pixelletter: common questions

Is Pixelletter MCP server safe?
Mostly: it is graded B (78/100). Read the Pixelletter safety report
How do I install Pixelletter?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Pixelletter need an API key?
Yes. The registry entry asks for PIXELLETTER_PASSWORD.
Is Pixelletter maintained?
The last commit was 100 days ago (2026-07-27). The latest release is v1.0.3.
How does Pixelletter compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 67% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from bitterdev →