src ▸ site opened 0

Turn USPS Tracking into a REST + MCP endpoint

Writ turns the USPS Tracking actions you already do in a browser into a callable REST endpoint your software (and your AI agents) can call.

Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
call-usps.shPOST /v1/usps/run
bash
curl -X POST https://api.usewrit.app/v1/usps/run \
  -H "Authorization: Bearer wt_8f2c...a91" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "query": "your search term" } }'
REST endpoint MCP tool structured JSON
new ▸ endpoint minted 01
02
create

No USPS Tracking API yet? Build one in minutes

Record the USPS Tracking task once (look up a tracking number, then read the latest scan) and call it as a REST endpoint and an MCP tool. No backend project, no waiting on USPS Tracking to ship an API.

  1. 1
    Record the USPS Tracking task once

    Open the recorder and look up a tracking number on USPS Tracking in a real browser. Writ captures each step, including login and 2FA, into a reusable workflow.

  2. 2
    Publish it as an endpoint

    One click turns the workflow into a callable REST endpoint at /v1/usps/run and a matching MCP tool. Inputs become a typed schema.

  3. 3
    Call it from anything

    Call USPS Tracking from your code, a no-code tool, or an AI agent. Run it on your own machine for free, or on metered cloud.

Read the REST API docs, see what's possible on workflows, or search for another site. Free to start. See pricing.

gap ▸ no public api 02
03
why

USPS Tracking doesn't give you the endpoint you need

USPS Tracking has an API, but USPS has a Web Tools API requiring registration; for ad-hoc tracking the public page returns the same status.

Writ closes that gap. Record the USPS Tracking task once (or describe it to an AI session) and publish it as a REST endpoint at /v1/usps/run and a matching MCP tool. Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.

ops ▸ actions mapped 03
04
operations

What you can call on USPS Tracking

Each operation below is a real USPS Tracking action recorded into a workflow and exposed as a typed endpoint.

{ }look up a tracking number
{ }read the latest scan
{ }export results

Returns structured fields such as tracking status, last scan, expected delivery, location: typed JSON, not raw page text.

run ▸ endpoint called 04
05
call it

A real USPS Tracking endpoint, authorized with a wt_ key

POST your inputs, get structured output. Authenticate every call with a scoped wt_ key.

cURL
bash
curl -X POST https://api.usewrit.app/v1/usps/run \
  -H "Authorization: Bearer wt_8f2c...a91" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "query": "your search term" } }'
Python
python
import requests

r = requests.post(
    "https://api.usewrit.app/v1/usps/run",
    headers={"Authorization": "Bearer wt_8f2c...a91"},
    json={"input": {"query": "your search term"}},
)
print(r.json()["output"])
response.json
json
{
  "run_id": "run_usps_7b21",
  "status": "succeeded",
  "output": {
    "tracking_status": "...",
    "last_scan": "...",
    "expected_delivery": "..."
  }
}
{ }

Also an MCP tool. The same workflow is exposed as an MCP tool your AI agent can call. See USPS Tracking MCP tools, or browse all MCP clients.

auth ▸ logged-in web 05
06
the hard web

Login, 2FA, and dynamic pages on USPS Tracking

The reason USPS Tracking has no usable API is the same reason it's hard to automate. Writ handles it.

USPS tracking pages are public; Writ renders them in real Chromium to capture the latest scan and status.

PersonasTOTP & mailbox OTP AI navigationReal Chromium rendering
build ▸ three routes 06
07
build

Three ways to build your USPS Tracking endpoint

Pick whichever fits the task. All three produce the same callable workflow.

Record itOpen the recorder, look up a tracking number on USPS Tracking once in a real browser, and Writ captures every step into a workflow.
Describe itTell an AI session your goal on USPS Tracking in plain language, and it drives the page to build the workflow for you.
Discover itLet API discovery watch USPS Tracking's own network calls as you browse, then turn the underlying requests into a fast workflow.

Built on the same engine as the recorder and workflows.

watch ▸ changes tracked 07
08
watch

Trigger your USPS Tracking endpoint on a change

Monitor USPS Tracking for status change, out for delivery, delivery exception and fire this endpoint the instant something changes.

Monitors check as fast as every 10s (10s on Enterprise). A detected change becomes an automation trigger that runs your workflow in seconds. Monitor USPS Tracking ▸

venue ▸ local or cloud 08
09
run it

Free on your own machine, or on cloud

Local / BYO agent

No compute charge. The agent runs on your hardware, so it can reach USPS Tracking even from an intranet or VPN-only network, and your AI keys never leave your machine.

Writ cloud

Metered by running time at $0.12 per browser-hour, drawn from your plan’s included usage. No infrastructure to manage.

faq ▸ questions answered 10
11
faq

USPS Tracking API questions

Does USPS Tracking have an API?
USPS Tracking has an API, but USPS has a Web Tools API requiring registration; for ad-hoc tracking the public page returns the same status. Writ gives you a callable /v1/usps/run endpoint that runs the real USPS Tracking flow in a browser and returns structured JSON.
Is there a ready-made USPS Tracking API I can use?
Record the USPS Tracking task once in the recorder (look up a tracking number, then read the latest scan) or describe it to an AI session. Writ turns it into a callable REST endpoint and MCP tool. It usually takes minutes, not a backend project.
Is it allowed to automate USPS Tracking this way?
Use Writ to track shipments you are authorized to track and respect USPS Terms of Use. Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
Does this work with USPS Tracking login and 2FA?
USPS tracking pages are public; Writ renders them in real Chromium to capture the latest scan and status. Writ handles TOTP and mailbox-OTP two-factor through Personas, so the endpoint runs inside your own authenticated session.
Can I run it on my own machine?
Yes. Run it on a local or BYO agent for no compute charge — useful when USPS Tracking is only reachable from your own network or VPN, and free on every plan. Or run it on metered cloud at $0.12 per browser-hour, drawn from your plan’s included usage.
rec ▸ ready

Build a USPS Tracking API

Record it once, then call it from your software and your AI agents. Get started free.