Docs

Quickstart

Send a test letter in four steps. Test keys render a real proof and post nothing.

The API is in design. Calls, fields and statuses on this page are illustrative.

1. Connect

Add the server to your MCP client with your test key.

{
  "mcpServers": {
    "atomside": {
      "url": "https://mcp.atomside.com",
      "headers": {
        "Authorization": "Bearer as_test_..."
      }
    }
  }
}

Illustrative. Hosts and field names are not final.

2. Get a quote

The quote checks the address, renders the letter and returns a price. Open the proof to see exactly what will print.

quote_letter({ "to": { ... }, "content_markdown": "...", "class": "second" })

3. Send it

Pass the quote and an idempotency key. Calling again with the same key returns the same letter.

send_letter({ "quote": "qt_...", "idempotency_key": "..." })

Held for approval? If the key requires approval, the status is awaiting_approval until someone approves by email.

4. Check status

get_letter({ "letter": "ltr_..." })
Illustrative statuses. Final names follow what the print supplier reports.
StatusMeaning
awaiting_approvalWaiting for a person
submittedAccepted by the printer
printedPrinted and enveloped
dispatchedHanded to Royal Mail
failedNot sent; credits returned to your balance