EchtPost integration
EchtPost prints real postcards with a real stamp and posts them (from Germany). Manage the address book of contacts and groups, browse postcard motives and saved templates, check that a text fits on a card, create postcards for one or many recipients (from a motive and text or from a template), list, read and cancel cards, and read the account balance and prices. Creating a card with a live key is billed and the card is printed and posted; a sandbox key (prefix ep_test_) stores everything separately and never bills or prints. Uploading a custom motive image (multipart, enabled by support) is not exposed. Authentication is an API key sent in the X-Api-Key header, created under Account, API keys in the EchtPost web app.
Say what should happen.
The workflow builds itself.
What you can do with EchtPost
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Contact, 5 operations
create_contactCreate contactPOSTSave a postal contact in the address book (name, street, zip, city, country and salutation style), optionally into groups. Returns the contact with its id for create_card recipient_ids.delete_contactDelete contactDELETEPermanently delete a saved contact from the address book, by id.get_contactGet contactGETRead one saved contact by id: name, postal address, salutation style and rendered greeting; include=groups or include=cards adds its group_ids or card_ids.list_contactsList contactsGETList address-book contacts, newest first by default; filter by group, country, external id, a substring search or exact name and address fields. Use it to find a contact id for create_card.update_contactUpdate contactPATCHChange fields of a saved contact; only the fields you send change, the others keep their value (greeting_style included).
Group, 5 operations
create_groupCreate groupPOSTCreate a contact group by name (and an optional external id). Returns the group with its id.delete_groupDelete groupDELETEDelete a contact group by id. Fails with 409 Conflict while the group still has members.get_groupGet groupGETRead one contact group by id: name, external id and recipient_count.list_groupsList groupsGETList contact groups, sorted by name by default, with each group's id and recipient_count. Use a group id as group_ids in create_card to mail every member.update_groupUpdate groupPATCHRename a contact group or change its external id; leave a field out to keep its current value.
Card, 4 operations
cancel_cardCancel cardDELETECancel a postcard before it reaches the print queue. Cancellation is asynchronous: returns id, status and cancelable; fails with 409 card-not-cancelable once the card is too far along (for example already sent).create_cardCreate cardPOSTCreate a postcard from a motive and your text, for saved contacts, groups or inline addresses. With a live key it is BILLED, printed and posted. Returns the card with id and status; cancel with cancel_card while cancelable.get_cardGet cardGETRead one postcard by id: status (pending, scheduled, sent, canceled), delivery date, text, font, number of recipients, whether it can still be canceled, and web_url to its print preview in the EchtPost web app.list_cardsList cardsGETList your postcards, newest first by default, filtered by status (pending, scheduled, sent, canceled), delivery date or motive. Returns an array of cards with id, status, deliver_at, contacts_count and cancelable.
Motive, 2 operations
get_motiveGet motiveGETRead one postcard motive by id: name, orientation, supported text fields (content, P.S., vertical text, QR code), preview image links and, for a temporary motive, when its images expire or were purged.list_motivesList motivesGETList postcard motives (front images) available to your account, account-owned first; search by keyword. Returns id, name, orientation, preview_image_url and which text fields each motive supports. Use an id as motive_id in create_card.
Template, 2 operations
get_templateGet templateGETRead one saved card template by id: motive, text, P.S., vertical text, font, QR code URL and preview_url.list_templatesList templatesGETList card templates saved in the EchtPost editor, with id, motive_id, text, font and preview_url. Use an id as template_id in create_card_from_template.
Credit, 1 operation
get_creditsGet creditsGETRead the account balance (EUR) with the number of domestic and foreign cards it covers, and the current price per domestic and per foreign card.
From template, 1 operation
create_card_from_templateCreate card from templatePOSTCreate a postcard from a template saved in the EchtPost editor, for saved contacts, groups or inline addresses. With a live key it is BILLED, printed and posted. Returns the card with id and status.
Me, 1 operation
get_accountGet accountGETRead the account behind the API key: account name, country and default greeting style, user email, key metadata and balance (credits in EUR and how many domestic and foreign cards it pays for).
Preview fit, 1 operation
check_card_text_fitCheck card text fitPOSTCheck whether a card text fits on the card at a given font, without creating anything: returns fits, lines_used, max_lines and, on overflow, overflow_line and suggested_font_size. Free.
Use EchtPost from Claude Code, Cursor or Codex
Connect EchtPost in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its EchtPost operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect EchtPost
- Create your workspace
Sign up free. Nothing to install.
- Connect EchtPost once
Add your EchtPost connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
EchtPost integration FAQ
What can you do with the EchtPost integration?
LiveContext exposes 22 operations on EchtPost, covering contact, group, card and motive.
