Skip to content
Agentmart
Submit a tool

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

IndexedMITLocal (stdio)★ 1
Write a review

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.

We use your email only for this newsletter. Privacy

About

MCP server for the Dropscan postal mail scanning API: read scanned letters, act on mailings.

No 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_address
  • get_mailing
  • get_mailing_plaintext
  • get_recipient
  • get_shipment
  • get_webhook_rule
  • list_mailings
  • list_recipients
  • list_scanboxes
  • list_webhook_rules

Write 6 · Create, change, send or run things.

  • cancel_mailing_action
  • create_forwarding_address
  • create_recipient
  • create_webhook_rule
  • set_mailing_recipient
  • update_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_envelope
  • get_mailing_pdf
  • get_mailing_zip
  • request_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_action

    Cancel 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_address

    Create 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_recipient

    Create 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_rule

    Create 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_rule

    Delete 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_address

    Get a forwarding address by id. Read-only. GET /forwarding_addresses/{id}

  • get_mailing

    Get one mailing with its details/extracted content. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}

  • get_mailing_envelope

    Download a mailing's envelope image (JPEG) and save it. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/envelope

  • get_mailing_pdf

    Download 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_plaintext

    Get OCR plaintext of a mailing (first 5 documents). Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/plaintext

  • get_mailing_zip

    Download a mailing's ZIP (individual PDFs) and save it. Read-only. GET /scanboxes/{scanbox_id}/mailings/{uuid}/zip

  • get_recipient

    Get one recipient of a scanbox. Read-only. GET /scanboxes/{scanbox_id}/recipients/{id}

  • get_shipment

    Get a shipment (physical forwarding batch) by id. Read-only. GET /shipments/{id}

  • get_webhook_rule

    Get one webhook rule by id. Read-only. GET /webhook_rules/{id}

  • list_mailings

    List 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_recipients

    List recipients configured for a scanbox. Read-only. GET /scanboxes/{scanbox_id}/recipients

  • list_scanboxes

    List all scanboxes on the account (GET /scanboxes). Read-only.

  • list_webhook_rules

    List all webhook rules on the account. Read-only. GET /webhook_rules

  • request_mailing_action

    Request 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_recipient

    Assign 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_rule

    Update 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
First seen
Oct 24, 2026
Last checked
Oct 25, 2026

More from bitterdev

Cite this page

Dropscan MCP. Agent Mart. https://agentmart.dev/connectors/bitterdev-dropscan-mcp (last updated 2026-10-25)