Posta ett brev från din AI-assistent

Anslut

Kopplingen är en fjärransluten MCP-server över Streamable HTTP. Den kräver ingen inloggning, så lämna autentisering avstängd.

• Claude: öppna Customize → Connectors, välj Add custom connector, ge den namnet Unopost och klistra in server-URL:en. Slå på Unopost i verktygsmenyn i en chatt.
• ChatGPT: lägg till en anpassad koppling i utvecklarläget med server-URL:en och utan autentisering, och slå sedan på den i chatten.
• Claude Code och andra klienter: lägg till den som en fjärransluten HTTP-server. Alla klienter som tar emot anpassade MCP-servrar använder samma URL.

claude mcp add --transport http unopost https://unopost.com.au/api/mcp

{
  "mcpServers": {
    "unopost": {
      "type": "http",
      "url": "https://unopost.com.au/api/mcp"
    }
  }
}

Så går ett brev till

1. Bekräfta adresserna
2. Gör i ordning brevet
3. Vänta på layouten
4. Användaren betalar på webbplatsen

Assistenten bekräftar adresserna med användaren, gör i ordning brevet och ger användaren en privat granskningslänk. Där kontrollerar användaren förhandsvisningen, anger en e-postadress och betalar med kort. Det är betalningen som gör att brevet postas.

Post this letter by Express Post to Jane Citizen,
12 Example Street, Southbank VIC 3006.
My return address is 1 Sample Road, Carlton VIC 3053.

Verktyg

Assistenterna anropar dem själva. Varje resultat från prepare_letter, finish_letter_upload och get_letter_status innehåller reviewUrl, den privata sidan där användaren kontrollerar förhandsvisningen och betalar, och instructions, som säger vad användaren ska få veta härnäst.

Gränser

pages

Upp till 80 sidor per brev. Dela upp ett längre dokument i separata brev.

regular

Vanlig post, och alla vikta brev, tar upp till 12 sidor. Längre brev går med Express Post, ovikta.

size

Upp till 50 MB per fil.

files

PDF, Word (.doc, .docx), JPEG eller PNG. Word-dokument läggs upp på A4.

letter

En fil per brev via kopplingen. Webbplatsen tar upp till 10.

rate

200 brev i timmen från varje AI-värd.

Statusar

CREATED

Reserverat, väntar på sin fil.

CONVERTING

Läggs upp.

CONVERTED AWAITING_PAYMENT

Klart för användaren att kontrollera och betala på reviewUrl.

PAID PAYING SENDING RETRYING MANUAL_CHECK

Betalt. Brev som betalas senast kl. 14.30 Melbournetid en arbetsdag postas samma dag.

POSTED UNDELIVERED

Inlämnat till Australia Post. Spårningsnumret har mejlats till användaren.

DELIVERED

Australia Posts spårning visar att det har levererats.

FAILED

Inte postat. error anger varför och instructions vad som ska göras härnäst. Ett betalt brev återbetalas i sin helhet.

PAYMENT_EXPIRED

Betalades inte i tid. Dokumentet har raderats.

REFUNDED

Avbrutet eller kunde inte postas, och återbetalat till kortet.

Fel

Ett verktyg som misslyckas returnerar ett felresultat vars text, skriven för assistenten, säger vad som gick fel och vad som ska göras. Det finns inga felkoder, och vi kan formulera om meddelandena, så agera på typen av fel, inte på exakt ordalydelse.

Ett verktyg betalar eller postar aldrig, så ett fel kostar aldrig användaren något. Men så fort ett fel nämner ett jobb finns det brevet: kontrollera det med get_letter_status i stället för att förbereda ett till.

arguments

Ett argument saknas eller är fel: en adress som användaren bör bekräfta, alternativ som inte går ihop, en filtyp som inte stöds, ett avvisat preparedFor eller en felaktig e-postadress. Meddelandet säger vilket. Rätta det och anropa igen; inget har skapats.

file

Originalfilen kunde inte hämtas från värden: länken har gått ut, avvisades, var för långsam eller omdirigerade för många gånger, pekar mot en privat adress, eller så är filen tom eller större än 50 MB. Inget har postats. Hämta en ny filreferens eller använd create_letter_upload; skicka aldrig en textkopia i stället.

job …

Meddelandet börjar med job …: när brevet skapades men ett senare steg misslyckades. Anropa get_letter_status med det jobb-ID:t och sedan finish_letter_upload om det fortfarande väntar på sina adresser. Förbered inte ett nytt brev.

rate limit

För många brev från den här AI-värden den här timmen, eller så har kopplingens gräns för dagen nåtts. Försök inte igen i en loop: be användaren försöka senare eller skicka brevet via Unopost-webbplatsen.

paused

Vi har pausat nya brev en stund; brev som redan är på väg fortsätter. Försök igen senare.

not found

Inget brev har det jobId, eller så har uppladdningen gått ut efter 24 timmar. Använd bara ett jobb-ID som Unopost har returnerat till den här användaren, och börja om om det har gått ut.

server

Något gick fel hos oss: Unopost API returned HTTP 5xx. Vänta några sekunder och försök en gång till.

FAILED

Ett brev som inte kan skrivas ut är inget verktygsfel: get_letter_status returnerar FAILED med error och tydliga instructions, till exempel att dela upp ett dokument på över 80 sidor eller ta bort ett lösenord.

Betalning och integritet

• Den betalar eller postar aldrig. Kopplingen returnerar ingen betalningslänk. Användaren betalar bara på webbplatsen, efter att ha sett förhandsvisningen.
• Originalfilen, oförändrad. Filer skickas aldrig inuti MCP-meddelanden och ersätts aldrig med text.
• Privata länkar. Ett jobb-ID är den enda nyckeln till ett brev, så assistenter delar det och reviewUrl bara med användaren.
• Avbryt före utskrift. Ett betalt brev kan avbrytas mot full återbetalning via reviewUrl tills vi börjar skriva ut det.
• Raderas efter postning. Dokument raderas när ett brev har postats, och ett obetalt brevs dokument efter 24 timmar.

Webhooks? Använd en inkorg

Kopplingen har inga webhooks. Ge i stället assistenten en notifyEmail till en inkorg som din programvara läser. Alla mejl om ett brev kommer från notifications@unopost.com.au och har brevet i sina huvudfält, så en e-posttjänst som kör kod på inkommande mejl, till exempel Amazon SES, Postmark, Mailgun eller SendGrid, kan agera på varje uppdatering när den kommer in.

1. Peka notifyEmail mot en adress som din e-posttjänst tar emot, till exempel letters@yourbusiness.com.au.
2. Ta bara emot mejl från notifications@unopost.com.au som klarar DMARC, och släng resten.
3. Läs huvudfälten, inte texten, som kan ändras. Släng ett Unopost-Event-Id som du redan har sett.

Huvudfält

Unopost-Letter-Id

Brevets jobId, så som kopplingen returnerade det.

Unopost-Event

Vad som hände: receipt, posted, tracking, retrying, delayed, awaiting-collection, delivered, cancelled, failed, refunded eller refunded-printed.

Unopost-Event-Id

Samma för samma nyhet hur ofta den än skickas, så att du kan slänga dubbletter.

Unopost-Letter-Status

Brevets status efteråt: TO_POST, POSTED, DELAYED, AWAITING_AT_COLLECTION, DELIVERED, CANCELLED eller REFUNDED.

Unopost-Tracking-Number

Australia Posts spårningsnummer, när brevet har postats.

Unopost-Copy

business på kopian som ett företag får; inte på kundens eget mejl.

From: Unopost <notifications@unopost.com.au>
Unopost-Letter-Id: 019d7a7f-a183-752d-9b3b-11511179033b
Unopost-Event: tracking
Unopost-Event-Id: evt_3f9a1c0b7e2d4a6b8c1d0e2f
Unopost-Letter-Status: POSTED
Unopost-Tracking-Number: 33LQV507012301000935005
Unopost-Copy: business

export const handler = async (event) => {
  const { mail, receipt } = event.Records[0].ses;
  const { from } = mail.commonHeaders;
  const fromUs = from.length === 1 && /(^|<)notifications@unopost\.com\.au>?$/i.test(from[0]);
  // DMARC, not DKIM alone: only a DMARC pass means unopost.com.au signed it.
  if (!fromUs || receipt.dmarcVerdict.status !== 'PASS') return;
  const header = name =>
    mail.headers.find(h => h.name.toLowerCase() === name.toLowerCase())?.value;
  await recordUpdate({
    letterId: header('Unopost-Letter-Id'),
    event: header('Unopost-Event'),
    eventId: header('Unopost-Event-Id'), // drop one you've seen
    status: header('Unopost-Letter-Status'),
    trackingNumber: header('Unopost-Tracking-Number'),
  });
};

Kopiorna börjar när kunden betalar, så inget kommer för ett brev som aldrig betalas: kontrollera med get_letter_status fram till dess. Kundens egna mejl har samma huvudfält. Vi kan lägga till huvudfält, men byter aldrig namn på eller tar bort dessa.

Upptäckt

Agenter kan hitta kopplingen utan att få veta om den. Den finns i vår AI-katalog, som pekar på dess MCP-serverkort.

• AI-katalog /.well-known/ai-catalog.json
• MCP-serverkort /.well-known/mcp/server-card.json

Priser

Alla brev är spårbara. Slutpriset beror på sidantalet, som blir känt när brevet har lagts upp.

För brev som görs i ordning via kopplingen gäller våra användarvillkor och vår integritetspolicy, precis som för alla andra.