Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Postagent is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Print & mail PDF/HTML/Markdown/text/DOCX/images to US addresses; pay per call in x402 USDC on Base.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http postagent-mcp https://api.postagent.sh/mcp
# 2 — ask your agent for something these tools do
# check_postagent_updates, create_letter, create_template and 11 more
Postagent costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http postagent-mcp https://api.postagent.sh/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
14 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Fetches the live PostAgent agent manifest. Call this before using PostAgent in a new session, after reconnecting the MCP server, or when an installed PostAgent skill may be stale. If the installed skill is older than latestSkillVersion, read latestSkillUrl and follow those instructions for this turn; if updateRequired is true, do not perform paid or irreversible PostAgent actions until the user up
| Parameter | Type | Required | Notes |
|---|---|---|---|
| installedSkillVersion | string | no | Version from the installed PostAgent SKILL.md frontmatter, if known. |
| installedMcpVersion | string | no | Version advertised by the connected PostAgent MCP server, if known. |
Upload and normalize a FINISHED, ready-to-mail document to PDF. Choose this when the content is final and IDENTICAL for every recipient — including when you mail the same letter to many people (just quote/pay once per recipient with the same documentId). The exact bytes you give are what gets printed. Use create_template instead only when the content must vary per recipient via {{fields}}. Returns
| Parameter | Type | Required | Notes |
|---|---|---|---|
| format | string | no | Source format. Inferred from contentType/filename/content when omitted; inline content with no format defaults to text. |
| content | string | no | Inline text content (html, markdown, or text). Provide exactly one source. |
| contentBase64 | string | no | Base64-encoded binary content (pdf, docx, image). Provide exactly one source. |
| url | string | no | Public URL the server will fetch the document from. Provide exactly one source. |
| filename | string | no | Optional original filename; used to help infer the source format. |
Upload a REUSABLE template containing {{field}} placeholders (e.g. Dear {{name}}, or Balance due: {{amount}}). Choose this ONLY when the content must vary per recipient (mail merge) — recipient count is irrelevant, so a single personalized letter belongs here too. If the content is identical for everyone, use create_letter instead (this tool rejects input with no {{fields}}). Returns a doc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| format | string | no | Template source format (text-based only). Inferred when omitted; inline content defaults to text. |
| content | string | no | Inline text content (html, markdown, or text). Provide exactly one source. |
| contentBase64 | string | no | Base64-encoded binary content (pdf, docx, image). Provide exactly one source. |
| url | string | no | Public URL the server will fetch the document from. Provide exactly one source. |
| filename | string | no | Optional original filename; used to help infer the source format. |
Verifies the recipient and sender US addresses and locks a 15-minute USDC price for a documentId. Does not charge or mail anything. Returns a paymentUrl (a per-quote x402-payable URL); the preferred way to actually mail the letter is for the agent's wallet to perform an in-band x402 payment against that URL (e.g. npx awal@latest x402 pay <paymentUrl>). The MCP submit_paid_mail_job tool is a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| documentId | string | yes | ID returned by create_letter (finished document) or create_template (mail-merge template) for the piece to mail. |
| from | object | no | Sender/return address. Required unless the server has a fallback configured. |
| to | object | yes | Recipient's US postal address. |
| options | object | no | — |
| mergeVariables | object | no | Values for a template document's {{merge fields}}, e.g. { "name": "Jane", "amount": "$42.00" }. Required when documentId refers to an html_template: every field listed in that document's mergeFields m |
Creates a Stripe-hosted Checkout page for a locked quote and returns a checkoutUrl plus a statusUrl. Use this as the LAST-RESORT payment rail, when the payer is a human paying by credit card (the agent cannot complete card entry itself). Hand the checkoutUrl to the user to open in a browser and pay; payment is asynchronous — once they finish, the letter is created automatically by Stripe's w
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteId | string | yes | — |
| webhookUrl | string | no | Optional caller-controlled webhook URL to receive job status updates. |
Autonomous, no-browser FIAT payment for a locked quote using a Stripe Shared Payment Token (SPT / Machine Payments Protocol). Use this when the agent can mint an SPT on the buyer's behalf and wants to pay by card/wallet without a human in a browser (prefer x402 first if the agent has a USDC-on-Base wallet; this is the autonomous fiat alternative). CHARGES MONEY AND IS IRREVERSIBLE: the server auth
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteId | string | yes | — |
| sharedPaymentToken | string | yes | A Stripe Shared Payment Token (spt_…) the agent minted for the buyer, scoped to this seller's Stripe profile (see the quote's mpp paymentOption.details.stripeProfileId) and to at least the quote amoun |
| webhookUrl | string | no | Optional caller-controlled webhook URL to receive job status updates. |
| userConfirmed | boolean | yes | Must be true. Set this only after the human user explicitly approved sending physical mail at the quoted price. |
Returns the x402 PAYMENT-REQUIRED challenge for a locked quote so an x402-capable wallet client can sign it. No payment is taken at this step. Probes the canonical per-quote pay URL (/v1/quotes/:quoteId/pay). The preferred way to actually pay is for the wallet to perform the standard x402 in-band handshake against paymentUrl; this tool is for inspection or for the detached-signature flow via `
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteId | string | yes | — |
Detached-signature fallback for x402 wallets that can emit a standalone PAYMENT-SIGNATURE header. THE PRIMARY/RECOMMENDED PATH is for the agent's wallet to pay the quote's paymentUrl in-band (e.g. npx awal@latest x402 pay <paymentUrl>); use this tool only if your wallet client cannot do that. Charges the agent in USDC on Base mainnet and creates a physical letter for printing and mailing. THIS
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteId | string | yes | — |
| paymentSignature | string | yes | x402 PAYMENT-SIGNATURE header value produced by an x402 client after signing the prepare_mail_payment challenge. |
| webhookUrl | string | no | Optional caller-controlled webhook URL to receive job status updates. |
| userConfirmed | boolean | yes | Must be true. Set this only after the human user explicitly approved sending physical mail at the quoted price. |
Returns normalized status, carrier/tracking/proof data, and tracking events for a previously created job.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| jobId | string | yes | — |
Upload ONE side of a postcard (front or back) as single-page PDF, PNG, or JPEG artwork. The file is stored VERBATIM — no page-size normalization and no reserved address zone — so you are responsible for the correct trim size plus bleed: 4x6 cards need 4.25"x6.25" artwork, 6x9 needs 6.25"x9.25", 6x11 needs 6.25"x11.25" (0.125" bleed on each edge). The selected delivery method prints the recipient a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| format | string | no | Artwork format; inferred from content when omitted. |
| contentBase64 | string | no | Base64-encoded single-page PDF, PNG, or JPEG artwork. |
| url | string | no | Public URL the server fetches the artwork from. |
| filename | string | no | — |
Verifies the recipient and sender addresses and locks a 15-minute USDC price for mailing a postcard built from two postcard_art documents (front + back, uploaded via create_postcard_art). Sizes: 4x6 (default), 6x9, 6x11 — postcards always print in full color. US recipients use the strict US address shape; INTERNATIONAL recipients are supported on 4x6 only (set to.country to the 2-letter ISO code
| Parameter | Type | Required | Notes |
|---|---|---|---|
| frontDocumentId | string | yes | documentId of the FRONT artwork (kind postcard_art). |
| backDocumentId | string | yes | documentId of the BACK artwork (kind postcard_art). The print partner prints the recipient address block over part of the back. |
| from | object | no | US sender/return address. Required unless the server has a fallback configured. |
| to | object | yes | Recipient address. |
| options | object | no | — |
Standalone paid address verification — no mail is sent. Checks whether an address is deliverable and returns the standardized form (US: CASS with ZIP+4; international: per-country matching). Costs a small flat USDC fee per call via x402 (a fraction of a cent vs. mailing). Two-step flow, like the mail rails: call WITHOUT paymentSignature to get the 402 challenge and paymentUrl (preferred: have
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Recipient/contact name (optional) |
| line1 | string | yes | Street address line 1 |
| line2 | string | no | — |
| city | string | no | — |
| state | string | no | State/province/region |
| zip | string | no | ZIP or postal code |
| country | string | no | 2-letter ISO country code. Omit or 'US' for CASS-standardized US verification; any other code runs international verification. |
| paymentSignature | string | no | x402 PAYMENT-SIGNATURE header value signed against this endpoint's challenge. Omit to fetch the challenge first. |
Quote ONE bulk send to MANY recipients (up to 500): a single template or static document, fulfilled through PostAgent's campaign workflow. Price is an inclusive customer-facing total, locked for 15 minutes. Payment is x402 ONLY. IMPORTANT — KYC WALL: campaigns require the paying wallet to be identity-verified with PostAgent. Verification is operator-run, not self-serve: until the wallet is verifi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| documentId | string | yes | Template (html_template) or finished letter (pdf) documentId. |
| name | string | no | Campaign name (for your records). |
| from | object | no | US sender/return address. Required unless the server has a fallback. |
| recipients | array | yes | One entry per recipient (1-500). |
| options | object | no | — |
| payerWallet | string | yes | The x402 wallet that will pay this quote. Must be KYC-verified with PostAgent (re-checked at payment against the wallet that actually signs). |
Returns a campaign's validation/sending progress: status (validating | sent | partial | failed), recipient counts (total / validated / failed), and a failures report URL when some recipients could not be validated. Polling this endpoint also advances the campaign (it releases the campaign for mailing once the print partner finishes validating the audience). Find the campaign id on the quote's job
| Parameter | Type | Required | Notes |
|---|---|---|---|
| campaignId | string | yes | Campaign id (cmp_…). |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Postagent or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.5.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Postagent can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.