
USPS Certified Mail: person-approved or trusted auto-send, with optional electronic Return Receipt.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel before submission to the printing partner and refund any payment in full. Read refund.state, refund.amount_cents and refund.destination in the result; do not claim a refund succeeded unless its state is accepted. Card refunds go back to the card paid with and usually show within 5 to 10 business days; the bank decides exactly when. Balance refunds return to the prepaid balance. Paid letters normally have a 30-minute hold. Canceling is free; a submitted letter cannot be canceled. Read the returned refund and next_step; cancellation does not mail anything. Use id with its API key, or the complete private letter_url. Example: {"letter_url":"https://certifiedmailsender.com/l/<id>?t=<token>"}
Letter id; send the API key that created it in Authorization.
Complete private letter_url or approval_url, including its t token.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http certified-mail https://certifiedmailsender.com/mcp
Cancel before submission to the printing partner and refund any payment in full. Read refund.state, refund.amount_cents and refund.destination in the result; do not claim a refund succeeded unless its state is accepted. Card refunds go back to the card paid with and usually show within 5 to 10 business days; the bank decides exactly when. Balance refunds return to the prepaid balance. Paid letters normally have a 30-minute hold. Canceling is free; a submitted letter cannot be canceled. Read the returned refund and next_step; cancellation does not mail anything. Use id with its API key, or the complete private letter_url. Example: {"letter_url":"https://certifiedmailsender.com/l/<id>?t=<token>"}
| Argument | Type | Description |
|---|---|---|
| id | string | Letter id; send the API key that created it in Authorization. |
| letter_url | string | Complete private letter_url or approval_url, including its t token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Letter id; send the API key that created it in Authorization."
},
"letter_url": {
"type": "string",
"description": "Complete private letter_url or approval_url, including its t token."
}
}
}Create a US domestic letter draft from exactly one of text, pdf_base64 or pdf_url. Creating a draft is free. Drafts cannot be edited. To change the text, an address or the service: create_letter with a new idempotency_key, give the person the new approval_url, then cancel_letter the old draft so the person cannot pay for the outdated draft. Tell the person the price from quote_letter before making the draft, unless they have already seen it. Unknown fields in the input, to or from are rejected with invalid_request; error.fix names each unknown field. Use organization for a company name, not company. For a return receipt, use service certified_err. An undeliverable address returns error.address_reason with a stable code, affected fields and USPS lookup URL; ask the person about that specific part. One page costs $9.04 for certified or $12.24 with an electronic Return Receipt; use quote_letter for the exact page count. Show approval_url to the person who will review and pay. For text, send the body from the greeting on; we add both addresses and the date. A different leading address block or date is refused with text_has_letterhead (422); remove the line named in the error. People who prefer to write or upload it themselves can use https://certifiedmailsender.com/send. Paid letters wait 30 minutes; send_now:true skips that hold only when the person asks. Screening still applies. Normally the person approves and pays; an auto-send key pays from its account balance. No refund once USPS accepts the letter, even if USPS can't deliver it. If the person mentioned a deadline, compare it with the delivery estimate and tell them plainly when the estimate falls after it. Test mode never mails. Example: {"to":{"name":"Jordan Lee","line1":"500 Market St","line2":"Suite 200","city":"Philadelphia","state":"PA","zip":"19106"},"from":{"name":"Sam Ortiz","line1":"12 Oak Ave","city":"Columbus","state":"OH","zip":"43215"},"service":"certified_err","text":"Dear Jordan,\n\n...","idempotency_key":"<a new UUID>"}
| Argument | Type | Description |
|---|---|---|
| to* | object | Recipient address, checked by our printing partner against USPS records. If undeliverable during creation, the request is refused with address_undeliverable (422) and no draft is created. Read error.address_reason for its stable code, affected fields, plain explanation and USPS lookup URL; ask the person the specific question rather than guessing variants. |
Read a letter's state, timeline, tracking, proof_of_mailing, acceptance_expected_by, cancel_until, send_now, refund and next step. proof_of_mailing gives the USPS acceptance record; cite its local date as the mailing date. acceptance_expected_by gives the Eastern deadline while waiting, and is null after an individual-piece scan even if acceptance is missing. Relay next_step for the plain explanation. refund gives state, amount_cents and destination (card or balance). accepted means the processor accepted it or the balance was credited, not that the bank has posted it; manual means we will refund it by hand. Address checks usually finish in seconds. A pending address_status is retried each minute for up to a day; read again after a minute. A busy queue or partner delay can slow the check. Reading is free and changes nothing. first_usps_scan identifies the earliest individual-letter scan, not shipment receipt; only proof_of_mailing establishes acceptance. partner_checked_at is the last successful tracking poll, not the scan date. files_deleted_at means downloads are gone. Repeated adjacent checks carry observations and last_at; at stays the first check. Timestamps are UTC RFC 3339 with milliseconds; date-only fields retain their documented calendar dates. If the person mentioned a deadline, compare it with the delivery estimate and tell them plainly when the estimate falls after it. Use id with its API key, or the complete private letter_url from create_letter. Example: {"letter_url":"https://certifiedmailsender.com/l/<id>?t=<token>"}
| Argument | Type | Description |
|---|---|---|
| id | string | Letter id; send the API key that created it in Authorization. |
| letter_url | string | Complete private letter_url or approval_url, including its t token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Letter id; send the API key that created it in Authorization."
},
"letter_url": {
"type": "string",
"description": "Complete private letter_url or approval_url, including its t token."
}
}
}List this API key's letters newest first, with cursor pagination. Listing is free and requires the creating API key; it changes nothing. first_usps_scan identifies the earliest individual-letter scan, not shipment receipt; only proof_of_mailing establishes acceptance. partner_checked_at is the last successful tracking poll, not the scan date. files_deleted_at means downloads are gone. Repeated adjacent checks carry observations and last_at; at stays the first check. Timestamps are UTC RFC 3339 with milliseconds; date-only fields retain their documented calendar dates. Pass next_cursor as cursor to read the next page. Example: {"limit":20}
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string"
}
}
}Get an itemized price for 1-10 pages or count a base64 PDF. Quoting is free. Unknown input fields are rejected with invalid_request; error.fix names each unknown field and the accepted fields. For a return receipt, use service certified_err. One page costs $9.04 for certified or $12.24 with an electronic Return Receipt; use quote_letter for the exact page count. Quoting never creates, pays for or mails a letter. No refund once USPS accepts the letter, even if USPS can't deliver it. If the person mentioned a deadline, compare it with the delivery estimate and tell them plainly when the estimate falls after it. Example: {"pages":1,"service":"certified"}
| Argument | Type | Description |
|---|---|---|
| pages | integer | Page count from 1 to 10. Provide exactly one of pages or pdf_base64; omit pages when providing a PDF. |
| service* | string | |
| pdf_base64 | string | A base64-encoded PDF whose pages we count for the quote. Provide exactly one of pages or pdf_base64; omit pages when providing a PDF. Neither field takes precedence: sending both is rejected, even if the counts agree. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"service"
],
"properties": {
"pages": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Page count from 1 to 10. Provide exactly one of pages or pdf_base64; omit pages when providing a PDF."
},
"service": {
"enum": [
"certified",
"certified_err"
],
"type": "string"
},
"pdf_base64": {
"type": "string",
"description": "A base64-encoded PDF whose pages we count for the quote. Provide exactly one of pages or pdf_base64; omit pages when providing a PDF. Neither field takes precedence: sending both is rejected, even if the counts agree."
}
},
"additionalProperties": false
}Skip a paid letter's 30-minute cancellation hold when the person asks to send it right away. This never bypasses screening and does not submit immediately. Idempotent while paid, screening or held for review; refused before payment or after submission or cancellation. Cancellation stays possible until submission, with no guaranteed extra time. Read the returned cancel_until and next_step; only the hold is skipped. Use id with its creating API key, or the complete private letter_url. Example: {"letter_url":"https://certifiedmailsender.com/l/<id>?t=<token>"}
| Argument | Type | Description |
|---|---|---|
| id | string | Letter id; send the API key that created it in Authorization. |
| letter_url | string | Complete private letter_url or approval_url, including its t token. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Letter id; send the API key that created it in Authorization."
},
"letter_url": {
"type": "string",
"description": "Complete private letter_url or approval_url, including its t token."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 20, 2026.
| from* | object |
| text | string | The letter body, from the greeting on. We add the sender's address, the date and the recipient's address. Complete matching leading blocks are removed; a different leading address block or date is refused with text_has_letterhead (422), naming the line to remove. Subject lines and addresses after the greeting or first prose are allowed. Provide exactly one of text, pdf_base64 or pdf_url. |
| pdf_url | string |
| service* | string | certified sends USPS Certified Mail with USPS tracking. certified_err adds the electronic Return Receipt: a USPS PDF with the recipient's signature, once USPS provides it. Choose certified_err when the person wants proof of receipt. |
| send_now | boolean | Choose true only when the person asks to skip the 30-minute cancellation hold after payment. Payment and any required approval are still required (auto-send pays from balance without per-letter approval), and every screening check must pass before submission. The letter can be canceled only until it is sent to the printing partner; skipping leaves no guaranteed cancellation period. |
| pdf_base64 | string |
| idempotency_key* | string | Use a new UUID for a new letter; reuse it with the same body on retries. Anonymous keys need at least 16 characters. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to",
"from",
"service",
"idempotency_key"
],
"properties": {
"to": {
"type": "object",
"required": [
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$"
},
"city": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"default": "",
"maxLength": 40,
"description": "Person's full name. Omit or leave empty when sending to an organization only; either name or organization must contain nonblank text."
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"line2": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"state": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"organization": {
"type": "string",
"minLength": 1,
"description": "Organization or company name. For an organization-only address, provide this and omit name. When both names are the same, we print the organization once."
}
},
"description": "Recipient address, checked by our printing partner against USPS records. If undeliverable during creation, the request is refused with address_undeliverable (422) and no draft is created. Read error.address_reason for its stable code, affected fields, plain explanation and USPS lookup URL; ask the person the specific question rather than guessing variants.",
"additionalProperties": false
},
"from": {
"type": "object",
"required": [
"line1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}(-\\d{4})?$"
},
"city": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"default": "",
"maxLength": 40,
"description": "Person's full name. Omit or leave empty when sending to an organization only; either name or organization must contain nonblank text."
},
"line1": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"line2": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"state": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"organization": {
"type": "string",
"minLength": 1,
"description": "Organization or company name. For an organization-only address, provide this and omit name. When both names are the same, we print the organization once."
}
},
"additionalProperties": false
},
"text": {
"type": "string",
"maxLength": 60000,
"description": "The letter body, from the greeting on. We add the sender's address, the date and the recipient's address. Complete matching leading blocks are removed; a different leading address block or date is refused with text_has_letterhead (422), naming the line to remove. Subject lines and addresses after the greeting or first prose are allowed. Provide exactly one of text, pdf_base64 or pdf_url."
},
"pdf_url": {
"type": "string"
},
"service": {
"enum": [
"certified",
"certified_err"
],
"type": "string",
"description": "certified sends USPS Certified Mail with USPS tracking. certified_err adds the electronic Return Receipt: a USPS PDF with the recipient's signature, once USPS provides it. Choose certified_err when the person wants proof of receipt."
},
"send_now": {
"type": "boolean",
"description": "Choose true only when the person asks to skip the 30-minute cancellation hold after payment. Payment and any required approval are still required (auto-send pays from balance without per-letter approval), and every screening check must pass before submission. The letter can be canceled only until it is sent to the printing partner; skipping leaves no guaranteed cancellation period."
},
"pdf_base64": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"description": "Use a new UUID for a new letter; reuse it with the same body on retries. Anonymous keys need at least 16 characters."
}
},
"additionalProperties": false
}