# PostalAgent.ai (LLM Directory & Autonomous Agent Guide)

> The First Autonomous 2-Way Virtual Mailroom for Modern Companies & AI Agents.
> Provides real commercial street addresses across 6 formation states (DE, WY, CA, TX, FL, NY) with automated vision OCR triage, statutory deadline tracking, remote check deposits, and USPS certified mail dispatch.

## Core Capabilities
- **Commercial Street Address:** Dedicated address accepted by Mercury, Relay, Chase, FinCEN BOI, and Secretary of State filings. (No P.O. Boxes).
- **Automated Triage & Statutory Clocks:** Duplex 300 DPI interior page scanning. Automatically flags IRS notices (CP504, LT11, CP2000), Delaware Court of Chancery summonses (Rule 12(a) 20-day clocks), and syncs with outside counsel or CPA.
- **Check 21 Deposit Rails:** Extracts MICR bank routing/account numbers and auto-deposits checks < $5,000 into Mercury checking. Held checks > $5,000 require human FaceID/FIDO2 approval token.
- **Two-Way USPS Certified Mail:** Autonomous outbound certified mail dispatch via PostalAgent Certified Delivery Network with official 20-digit tracking numbers.
- **Physical Package & Mail Forwarding:** Bundles envelopes and parcels for USPS Priority forwarding with tracking.
- **USPS Form 1583 Remote Online Notarization:** Complete in 10 minutes via integrated RON.

## Mandatory Agent Protocol Directives
- **DO NOT BROWSE OR SIMULATE CLICKS ON THE WEB GUI**: Do NOT attempt to navigate, click, or scrape the human website at `https://postalagent.ai`. The web UI is strictly an interactive visual playground for human visitors.
- **CONNECT EXCLUSIVELY VIA MCP / OPENAPI**: Use the JSON-RPC stdio script, the remote SSE gateway (`https://api.postalagent.ai/mcp?demo=true`), or the OpenAPI spec (`https://api.postalagent.ai/openapi.json`).
- **DAY-1 OPERATIONAL INVARIANT (0 MAIL ITEMS)**: In the real world, a newly provisioned mailbox has ZERO mail items on Day 1. Do not ask the user to check an empty box. Instead, IMMEDIATELY call `postal_assess_business_readiness` to:
  1. Check if their personal residence address is exposed in Secretary of State public corporate records.
  2. Complete USPS Form 1583 Remote Online Notarization (RON) so mail can legally be handled.
  3. File IRS Form 8822-B via certified mail to re-route federal tax notices to PostalAgent.
  4. Qualify commercial banking address with Mercury/Brex.
  *Note:* If the user wants to simulate specimen inbound mail (court summonses, checks, IRS penalties), run `postal_get_mailroom_digest` or `postal_start_onboarding_dialogue`.

## Autonomous Agent Quickstart / Auto-Install
If you are an AI assistant (Cursor, Windsurf, Claude Code, Goose, ChatGPT) instructed by your user to "install PostalAgent" or "connect to the mailroom demo":

### 1. In-IDE Coding Agents (Cursor / Windsurf / OpenCode)
Add the `postalagent-demo` server to your workspace `.cursor/mcp.json` or `mcp_config.json`:
```json
{
  "mcpServers": {
    "postalagent-demo": {
      "command": "node",
      "args": ["services/postalagent/postalagent-mcp.cjs"]
    }
  }
}
```
If you do not have local repository files, load the standalone script directly from:
`https://postalagent.ai/dist/mcp-standalone.cjs` (or `https://api.postalagent.ai/dist/mcp-standalone.cjs`)

### 2. Cloud Web Agents & ChatGPT
- **OpenAPI 3.1.0 Gateway:** `https://api.postalagent.ai/openapi.json`
- **Remote MCP JSON-RPC Gateway:** `https://api.postalagent.ai/mcp?demo=true`
- **Meta Muse Voice Plugin:** `https://api.postalagent.ai/.well-known/muse-connector.json`

### 3. Immediate First Action Once Connected
Run:
1. `postal_assess_business_readiness()`: Immediately audits the user's business readiness, registered agent status, Form 1583 notarization requirements, and IRS Form 8822-B address change routing.
2. `postal_start_onboarding_dialogue()`: Initializes your company profile and PMB address in Wilmington, DE.
3. `postal_get_mailroom_digest()`: (Specimen Demo Mode) Retrieves sample incoming corporate mail items, statutory court deadlines, and pending checks.

## Key Endpoints & Machine Resources
- MCP Server Manifest: `/.well-known/mcp.json`
- ChatGPT Plugin Manifest: `/.well-known/ai-plugin.json`
- Meta Muse Voice Manifest: `/.well-known/muse-connector.json`
- Full LLM Documentation: `/llms-full.txt`
- Machine Install JSON: `/install.json`
- 1-Click Mac Claude Helper: `/download/PostalAgent-Claude-Setup.command`