Postface API

Connect Postface to Muse and other apps with a personal API key, over MCP or REST.

The Postface API lets an app you trust — like Muse — read your digests, run and create Blueprints, and text you. Every key reaches only your own account.

1. Create a key

In the app, open the profile menu and choose API keys. Name it, tap Create, and copy the key (it starts with pf_live_ and is shown once). Revoke it any time.

2. Connect over MCP (recommended for Muse)

Add a tool server with the address https://postface.io/api/public/mcp and send the key as Authorization: Bearer pf_live_…. Tools: list_digests, list_blueprints, run_blueprint, create_blueprint, send_text.

3. Or call the REST API

GET /api/public/v1/digests?limit=5
GET /api/public/v1/blueprints
POST /api/public/v1/blueprints with { "prompt": "…" }
POST /api/public/v1/blueprints/:id/run with { "text_me": true }
POST /api/public/v1/messages with { "message": "…" }

Limits

60 requests a minute per key; 20 texts a day per key.
Texts go only to your own phone and count toward your normal daily text limit.
Your plan's Blueprint limits and integrations still apply.

Questions? Email support@postface.io.