Dropscan MCP
MCP server for the Dropscan postal mail scanning API: read scanned letters, act on mailings.
Connector by bitterdev · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/bitterdev-dropscan-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 10 read · 6 write · 1 delete · 4 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Python package
Tools by what they do 21
Read from the source code; the running server may list different tools.
Read 10 · Look things up without changing anything.
get_forwarding_addressget_mailingget_mailing_plaintextget_recipientget_shipmentget_webhook_rulelist_mailingslist_recipientslist_scanboxeslist_webhook_rules
Write 6 · Create, change, send or run things.
cancel_mailing_actioncreate_forwarding_addresscreate_recipientcreate_webhook_ruleset_mailing_recipientupdate_webhook_rule
Delete 1 · Delete, drop, revoke or wipe things.
delete_webhook_rule
Not yet classified 4 · We could not tell from the name and description.
get_mailing_envelopeget_mailing_pdfget_mailing_ziprequest_mailing_action
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
DROPSCAN_API_TOKEN
Other settings (environment variables or headers).
DROPSCAN_ALLOW_WRITES
Tools (21)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
cancel_mailing_actionCancel a pending action request on a mailing. ⚠️ Changes the real production account. Cancellation windows apply (scan: 10 min, destroy: 60 min, forward: before the requested date, Berlin time). Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. DELETE /scanboxes/{scanbox_id}/mailings/{mailing_uuid}/action_requests/{id}
create_forwarding_addressCreate a forwarding address (used as a forward target). ⚠️ Changes the real production account. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. POST /forwarding_addresses Args: country_code: 2-3 char ISO country code (e.g. "DE"). zip_code: Postal code (sent as "zip" in the request body).
create_recipientCreate a recipient on a scanbox. ⚠️ Changes the real production account. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. POST /scanboxes/{scanbox_id}/recipients Args: type: "Person" or "Company". firstname, lastname: Required when type="Person". name: Required when type="Company".
create_webhook_ruleCreate a webhook rule. ⚠️ Changes the real production account. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. POST /webhook_rules Args: events: One or more of: mailing_received, scan_requested, mailing_scanned, mailing_archived, mailing_trashed, mailing_shredded, mailing_added_to_shipment, mailing_removed_from_shipment, shipment_sent, package_tracking_updated.
delete_webhook_ruleDelete a webhook rule. ⚠️ Changes the real production account and cannot be undone. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. DELETE /webhook_rules/{id}
get_forwarding_addressGet a forwarding address by id. Read-only. GET /forwarding_addresses/{id}
get_mailingGet one mailing with its details/extracted content. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}
get_mailing_envelopeDownload a mailing's envelope image (JPEG) and save it. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/envelope
get_mailing_pdfDownload a mailing's scanned PDF and save it to disk. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/pdf Args: save_path: Absolute path to write the PDF to. Defaults to ~/Downloads/dropscan-<uuid>.pdf (or DROPSCAN_DOWNLOAD_DIR).
get_mailing_plaintextGet OCR plaintext of a mailing (first 5 documents). Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/plaintext
get_mailing_zipDownload a mailing's ZIP (individual PDFs) and save it. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/zip
get_recipientGet one recipient of a scanbox. Read-only. GET /scanboxes/{scanbox_id}/recipients/{id}
get_shipmentGet a shipment (physical forwarding batch) by id. Read-only. GET /shipments/{id}
get_webhook_ruleGet one webhook rule by id. Read-only. GET /webhook_rules/{id}
list_mailingsList mailings in a scanbox (GET /scanboxes/{id}/mailings). Read-only. Args: scanbox_id: Scanbox id (e.g. "12345"). current_status: Optional status filter. One of: received, scan_requested, scanned, destroy_requested, destroyed, forward_requested, forwarded. older_than: Optional mailing UUID cursor for pagination; returns mailings older than the given one.
Show 6 more tools
list_recipientsList recipients configured for a scanbox. Read-only. GET /scanboxes/{scanbox_id}/recipients
list_scanboxesList all scanboxes on the account (GET /scanboxes). Read-only.
list_webhook_rulesList all webhook rules on the account. Read-only. GET /webhook_rules
request_mailing_actionRequest a physical action on a mailing (scan / forward / destroy). ⚠️ AFFECTS THE REAL PRODUCTION ACCOUNT AND CANNOT BE UNDONE. "destroy" physically shreds the letter, it is gone for good. "forward" physically mails the letter to an address and incurs cost. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. POST /scanboxes/{scanbox_id}/mailings/{mailing_uuid}/action_requests Args: action_type: One of "scan", "forward", "destroy". forwarding_address_id: Required when action_type="forward"; the id of a forwarding address (see create_forwarding_address / get_forwa…
set_mailing_recipientAssign a recipient to a mailing. ⚠️ Changes the real production account. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. PUT /scanboxes/{scanbox_id}/mailings/{mailing_uuid}/recipient
update_webhook_ruleUpdate a webhook rule. ⚠️ Changes the real production account. Double-gated: requires DROPSCAN_ALLOW_WRITES=1 AND confirm=true. PATCH /webhook_rules/{id}
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 27
- Last commit
- Oct 19, 2026 (10 days ago)
- Last release
- Jul 27, 2026 (3 months ago)
- Last package publish
- Jul 27, 2026 (3 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.bitterdev/dropscan-mcp- Version
- 0.1.1
- Auth
- API key
- Packages
- pypi dropscan-mcp
- License
- MIT
- Repository
- github.com/bitterdev/dropscan-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from bitterdev
- 0.529score
Veracrypt MCP
bitterdev
MCP server to mount and unmount VeraCrypt containers with secure stdin password handling.
ConnectorAFreshness: ALocal★ 1↓ 30/wkClaude Code +5 - 0.525score
Enpass MCP
bitterdev
MCP server for Enpass vaults: entries, passwords and TOTP/2FA codes, keychain-backed.
ConnectorAFreshness: ALocal★ 3Claude Code +5 - 0.505score
PDF Letter MCP
bitterdev
Renders letters as print ready PDFs, DIN 5008 compliant for German window envelopes.
ConnectorAFreshness: ALocalClaude Code +5 - 0.505score
Pixelletter MCP
bitterdev
Send physical letters and faxes through the PixelLetter interface, test mode included.
ConnectorAFreshness: ALocalClaude Code +5 - 0.495score
Simple Support System MCP
bitterdev
MCP server for the Simple Support System helpdesk API: read, answer and move tickets.
ConnectorAFreshness: ALocalClaude Code +5
Cite this page
Dropscan MCP. Agent Mart. https://agentmart.dev/connectors/bitterdev-dropscan-mcp (last updated 2026-10-25)