accueil / serveurs / Communication / dev.paperagent/letters
dev.paperagent/letters
serveur MCP (Model Context Protocol) · paperagent 0.1.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que dev.paperagent/letters est sûr ?
Au dernier audit MCP Hub, le serveur MCP « dev.paperagent/letters » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 8 outils
- create_draft≈ 1978 tokens
Create a draft of a physical letter to be printed on paper and mailed through USPS, and return its draft_id, page count and total price. A letter is at most 6 printed pages, at the same price whatever its length: up to 3 pages print one-sided, 4 to 6 print on both sides. Write the body to fit, or split a longer document into two letters, because a body that renders to 7 or more pages is refused rather than trimmed. This is NOT email, fax or text message — nothing reaches the recipient electronically, and the only way this letter arrives is on paper in an envelope. The body is plain text or Markdown. The draft freezes the content and the price for 24 hours and costs nothing; no paper is printed and no postage is bought until send_letter is called. US domestic addresses only. Call preview_draft next so the user can see the letter and the total.
Paramètres, retour & exemple (6)
Paramètresto· object · requis
Who the letter is mailed to.tier· string · optionnel · standard | proof_of_mailing | certified | certified_err | registered
Defaults to standard. Call get_pricing first and pass a tier it lists: standard is a plain First-Class letter. certified, certified_err, proof_of_mailing and registered are other products the current price card may not sell, and a tier it does not sell is refused, not substituted — so do not describe one to the user until get_pricing has listed it.colour· boolean · optionnel
Omit this. The current price card prints every letter black & white, so passing true is refused rather than billed — call get_pricing for what it does sell. The field remains because letters priced on an older card carry it.body_file· object · optionnel
A file the user attached, as the host delivers it. Not accepted yet — create_draft refuses an attachment and asks for the letter as body_markdown text.body_markdown· string · requis
The text of the letter, as plain text or Markdown. It must render to 6 printed pages or fewer — roughly 2,400 words of body text.from_address_id· string · optionnel
Omit this. The account's own verified return address is used by default; only pass an id the account holder gave you.
Exemple d'appel{"name": "create_draft", "arguments": {"to": {}, "body_markdown": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"note": "texte", "tier": "standard", "quote": {}, "draft_id": "texte", "expires_at": "texte", "page_count": 1, "tier_title": "texte", "sheet_count": 1, "included_pages": 1}} - get_letter_status≈ 1167 tokens
Return the current state of one letter: where it is, the date it goes to USPS, and the estimated delivery date. USPS does not scan plain First-Class letters at delivery, so a Standard letter ends at an expected delivery date and never reports delivery — do not tell the user a letter arrived unless the status itself says so. This creates nothing and mails nothing.
Paramètres, retour & exemple (1)
Paramètresletter_id· string · requis
Exemple d'appel{"name": "get_letter_status", "arguments": {"letter_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"tier": "standard", "scans": [], "status": "pending_payment", "payment": {}, "livemode": true, "letter_id": "texte", "mail_date": "texte", "created_at": "texte", "disclosure": "texte", "description": "texte", "cancelled_at": "texte", "delivered_at": "texte"}} - get_pricing≈ 1336 tokens
Return the published price list for mailing physical letters through USPS: the products on sale, what each one costs, how many pages it covers, and when sales tax applies. Amounts are in US cents. Every letter is one of these prices — there is no volume discount, no per-page charge and no colour printing — so quote the tier total and say New York sales tax is added, whatever the destination. Call this before telling a user what a letter will cost. This creates nothing and mails nothing.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_pricing", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"tax": {}, "tiers": [], "add_ons": [], "country": "texte", "version": "texte", "currency": "texte", "page_rules": {}, "effective_from": "texte", "volume_pricing": {}}} - list_letters≈ 640 tokens
Return this account's letters, newest first, with the status, mail date and total for each. Use this to answer questions about what has already been sent. This creates nothing, changes nothing and mails nothing.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
Defaults to 20.starting_after· string · optionnel
The next_cursor from the previous call, to read the following page.
Exemple d'appel{"name": "list_letters", "arguments": {"limit": 1, "starting_after": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"letters": [], "has_more": true, "next_cursor": "texte"}} - preview_draft≈ 1175 tokens
Return a link to the rendered PDF of a draft together with its page count and current total price. Refreshes the stored price quote when pricing has changed. Use this to show the user exactly what will be printed and exactly what it costs before calling send_letter. The total in the response is the number send_letter requires as confirm_total_cents. This does not create an order or mail a letter.
Paramètres, retour & exemple (1)
Paramètresdraft_id· string · requis
Exemple d'appel{"name": "preview_draft", "arguments": {"draft_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"tier": "standard", "quote": {}, "draft_id": "texte", "expires_at": "texte", "page_count": 1, "tier_title": "texte", "preview_url": "texte", "requirements": [], "included_pages": 1}} - send_letter≈ 1348 tokens
Create an order for a real, physical letter through the United States Postal Service. It returns a payment link; no paper is printed, postage is bought, or letter is mailed until payment completes. Use this whenever the user asks to mail, post, send by post, or physically send a letter, notice, or document to a street address. This is NOT email — use an email tool for email. US domestic addresses only. Requires a draft_id from create_draft and confirm_total_cents matching the current quote. The letter becomes irreversible once we print it.
Paramètres, retour & exemple (3)
Paramètresdraft_id· string · requis
The draft_id returned by create_draft or preview_draft.idempotency_key· string · requis
A key you generate once for this send. Retrying with the same draft_id and the same key returns the original letter instead of mailing a second one.confirm_total_cents· integer · requis
The exact total.amount_cents from the current quote, including sales tax. Say the total out loud to the user first; if it does not match the live quote this call fails and no letter is sent.
Exemple d'appel{"name": "send_letter", "arguments": {"draft_id": "texte", "idempotency_key": "texte", "confirm_total_cents": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"quote": {}, "status": "pending_payment", "message": "texte", "order_id": "texte", "letter_id": "texte", "checkout_url": "texte", "mail_date_estimate": "texte"}} - update_draft≈ 1658 tokens
Change the recipient, body, tier or colour of a draft that has not been sent, and re-price it. Returns a new page count and a new quote, so the previous total is void — state the new total to the user before sending. The 6-printed-page maximum applies to the new body as well: a replacement that renders to 7 or more pages is refused and the draft is left as it was. This creates nothing and mails nothing.
Paramètres, retour & exemple (6)
Paramètresto· object · optionnel
A complete US postal address. US domestic addresses only.tier· string · optionnel · standard | proof_of_mailing | certified | certified_err | registered
Which product to buy. Call get_pricing first and pass a tier it lists: standard is a plain First-Class letter. certified, certified_err, proof_of_mailing and registered are other products the current price card may not sell, and a tier it does not sell is refused rather than substituted — so do not describe one to the user until get_pricing has listed it.colour· boolean · optionnel
Omit this. The current price card prints black & white only; true is refused.draft_id· string · requis
The draft_id returned by create_draft.body_markdown· string · optionnel
Replaces the whole letter text. It must render to 6 printed pages or fewer — roughly 2,400 words of body text.from_address_id· string · optionnel
Exemple d'appel{"name": "update_draft", "arguments": {"draft_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"note": "texte", "tier": "standard", "quote": {}, "draft_id": "texte", "expires_at": "texte", "page_count": 1, "tier_title": "texte", "sheet_count": 1, "included_pages": 1}} - validate_address≈ 703 tokens
Check a US postal address and return it in the normalized form the envelope will be printed with, plus any warnings. The address is checked against the Google Address Validation service, which receives the address and nothing else. Use this before create_draft whenever the address came from a person rather than from an earlier tool result. Requires a complete street address: this does not look up, append or find an address from a name, and it does not handle addresses outside the United States. This creates nothing and mails nothing.
Paramètres, retour & exemple (1)
Paramètresaddress· object · requis
A complete US postal address. US domestic addresses only.
Exemple d'appel{"name": "validate_address", "arguments": {"address": {}}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"address": "texte", "message": "texte", "corrections": [], "deliverable": true}}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».