io.github.iancollins27/mailsnail
NPM · MAILSNAIL · SCANNED AUG 3
Send USPS letters, postcards & certified mail from any agent. No signup; pay-per-piece via Stripe.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 20 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability54
- AI-judged instruction clarity (fair).Partial
- Context-footprint check failed: tool/resource definitions use about 911 tokens (~130/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage79
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 37% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · mailsnail
claude mcp add iancollins27-mailsnail -- npx -y mailsnail
codex mcp add iancollins27-mailsnail -- npx -y mailsnail
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"iancollins27-mailsnail": {
"type": "local",
"command": [
"npx",
"-y",
"mailsnail"
],
"enabled": true
}
}
} openclaw mcp add iancollins27-mailsnail --command npx --arg -y --arg mailsnail
mcp_servers:
iancollins27-mailsnail:
command: "npx"
args: ["-y", "mailsnail"] {
"mcpServers": {
"iancollins27-mailsnail": {
"command": "npx",
"args": [
"-y",
"mailsnail"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +41
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: 100 → unverified ▼ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → fair ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Schema quality: unverified functional
- Licence: MIT functional
- 31 Jul 26 −24
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Jul 26 42
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 96 packages
96 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
cancel_letter ~35
Cancel a letter before it enters production. Cancellation windows are short and provider-specific.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Provider letter/job id. |
No output schema declared.
No examples provided.
get_letter ~30
Fetch the status of a previously sent letter by id.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Provider letter/job id. |
No output schema declared.
No examples provided.
list_letters ~47
List recent letters (Lob only — Click2Mail does not expose a list endpoint).
| Name | Type | Req | Description |
|---|---|---|---|
| after | string | — | — |
| before | string | — | — |
| limit | integer | — | — |
No output schema declared.
No examples provided.
preview_letter ~212
Generate a PROOF of a letter WITHOUT charging or mailing. Returns `proof_url` (a viewable PDF of exactly what will be printed and mailed, including the address cover sheet), the CASS-verified recipient address, the exact price, and a `draft_id`. Best practice: call this FIRST, show the user the proof_url and price, get explicit confirmation, then call send_letter with the returned draft_id + a payment_token. Managed/gateway mode only.
| Name | Type | Req | Description |
|---|---|---|---|
| body_text | string | — | Plain text body. Rendered to a letter-sized PDF server-side. Managed/gateway provider only. |
| color | boolean | — | — |
| description | string | — | — |
| double_sided | boolean | — | — |
| extra_service | string | — | Adds tracking. `certified` for legal/compliance mail. |
| file_url | string | — | Public URL to a pre-rendered PDF letter. Letter-size 8.5x11 expected. |
| from | — | yes | — |
| to | object | yes | — |
No output schema declared.
No examples provided.
send_letter ~355
Send a physical letter via USPS. RECOMMENDED FLOW: first call preview_letter, show the user the returned proof_url + price, get explicit confirmation, then call send_letter with the returned `draft_id` and a `payment_token` — this charges and mails exactly the proofed letter. You may also send one-shot by providing the full letter (to, from, and body_text or file_url) plus payment_token, without a draft_id. `body_text` (plain text, rendered server-side) is managed/gateway-mode only; click2mail/lob require file_url. Use `extra_service: 'certified'` for certified mail (recommended for legal notices).
| Name | Type | Req | Description |
|---|---|---|---|
| body_text | string | — | Plain text body of the letter. Newlines preserved. Rendered to a letter-sized PDF server-side. Managed/gateway provider only. |
| color | boolean | — | — |
| description | string | — | — |
| double_sided | boolean | — | — |
| draft_id | string | — | Confirm a letter previewed via preview_letter. Provide this plus payment_token to charge and mail exactly that proof. Omit for a one-shot send. |
| extra_service | string | — | Adds tracking. `certified` is the most common; useful for legal/compliance mail. |
| file_url | string | — | Public URL to a pre-rendered PDF letter. Letter-size 8.5x11 expected. |
| from | — | — | — |
| payment_token | string | — | Stripe Shared Payment Token (spt_...). Required when MAIL_PROVIDER=managed. If omitted in managed mode, the tool returns a payment_required error with the quoted price so you can mint an SPT and retr… |
| to | object | — | — |
No output schema declared.
No examples provided.
send_postcard ~163
Send a physical postcard. Provide a public URL to a PDF (front + back combined for Click2Mail; separate front/back for Lob).
| Name | Type | Req | Description |
|---|---|---|---|
| back_url | string | — | URL to PDF for the postcard back. Required for Lob; ignored for Click2Mail. |
| description | string | — | — |
| from | — | yes | — |
| front_url | string | yes | URL to PDF for the postcard front (or combined front+back for Click2Mail). |
| payment_token | string | — | Stripe Shared Payment Token (spt_...). Required when MAIL_PROVIDER=managed. If omitted in managed mode, the tool returns a payment_required error with the quoted price so you can mint an SPT and retr… |
| size | string | — | — |
| to | object | yes | — |
No output schema declared.
No examples provided.
verify_address ~69
Verify and normalize a US mailing address. Run this on user-provided addresses before sending mail.
| Name | Type | Req | Description |
|---|---|---|---|
| address_city | string | — | — |
| address_line1 | string | yes | — |
| address_line2 | string | — | — |
| address_state | string | — | — |
| address_zip | string | — | — |
No output schema declared.
No examples provided.