create_contact
Create Contact
Create a new recipient contact in your EchtPost account. The contact can then be referenced by ID when sending postcards, avoiding the need to provide address details each time.
Ask your agent in plain language. Each of these maps to a real tool on the server.
create_contact
Create a new recipient contact in your EchtPost account. The contact can then be referenced by ID when sending postcards, avoiding the need to provide address details each time.
list_templates
Retrieve a page of saved postcard templates from your EchtPost account. Templates are created in the EchtPost web interface and referenced by ID when sending postcards.
list_contacts
Retrieve a page of recipient contacts from your EchtPost account. Filter by name/address search, country, group, or external reference. Returns contact IDs for sending postcards.
send_postcard
Schedule a real physical postcard for delivery using a pre-designed template. Recipients can be specified inline with address details, by referencing existing contact IDs, or by targeting an entire recipient group. Optional email notifications can be configured to alert before or after sending.
get_group
Read one recipient group, including its name, external reference, and recipient count.
get_credits
Read your prepaid balance, available domestic and foreign postcard counts, and current per-card prices.
delete_group
Delete a recipient group. EchtPost rejects groups that still have members or are in use; remove memberships before retrying.
list_cards
List postcards with optional status, printing date, and motive filters. Use the returned IDs to inspect or cancel a postcard.
delete_contact
Permanently delete a recipient contact from EchtPost.
update_group
Rename a recipient group or update its external reference. Omitted fields stay unchanged.
create_group
Create an empty recipient group. Add contacts using the groupIds or groupNames fields on Create Contact or Update Contact.
get_template
Read a saved postcard template by ID, including its content, font, motive, and preview link when available.
update_contact
Update a recipient contact. Omitted fields stay unchanged. groupIds replaces memberships; groupNames adds named groups, creating missing groups.
get_contact
Retrieve one recipient contact, optionally including its group memberships and postcard IDs.
who_am_i
Identify the connected EchtPost account and user, with API-key metadata and the current prepaid balance.
cancel_card
Queue cancellation of a postcard that is still cancelable. Acceptance is asynchronous; use Get Postcard to check its resulting status.
get_card
Read a postcard and its delivery status and cancelable flag.
list_groups
List recipient groups and their member counts. Use the returned group IDs when scheduling postcards or managing contact memberships.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Send physical postcards using saved EchtPost templates. Create, update, and organize recipient contacts and groups, find templates, schedule mailings, inspect postcard status, queue cancellation, and check the connected account, prepaid balance, and prices.
Common questions about connecting Echtpost to AI agents with Metorial.