@formstr/mcp 0.5.0 → 0.6.0

package/README.md

@@ -2,8 +2,10 @@
 
 A standalone [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that
 exposes the **Formstr** super-app (forms, calendar, pages, drive, polls) to any MCP host —
-Claude Code/Desktop, Cursor, and others. It builds on `@formstr/core` and the super-app's
-service layer and talks to Nostr relays directly. Transport: **stdio**.
+Claude Code/Desktop, Cursor, and others. It builds on `@formstr/agent` (the shared service
+layer + tool registry) and `@formstr/core` (Nostr primitives), and talks to Nostr relays
+directly. Transport: **stdio**. Source lives in
+[`formstr-hq/common-packages`](https://github.com/formstr-hq/common-packages/tree/main/packages/mcp).
 
 Identity is powered by [`@formstr/signer`](https://www.npmjs.com/package/@formstr/signer) —
 the same login engine the Formstr web app uses. Local keys are stored **NIP-49 encrypted
@@ -225,6 +227,26 @@ service supports (more than the super-app builder UI currently exposes).
 Other modules (calendar, pages, polls, drive) expose the v1 read/create tools and gated
 actions; see the source under `src/tools/`.
 
+## Mail tools
+
+Email through mailstr, using the same identity you logged in with (the account the
+`you@mailstr.app` address is bound to). No key material leaves the signer.
+
+**Read (always on)**
+
+- `list_mail` — your inbox: sender, subject, date per message (kind-1059 gift-wrapped mail).
+- `read_mail` — the full body of one message by its id.
+- `who_is_my_mail_address` — the account's mail address (NIP-05) and pubkey.
+
+**Gated (require `--allow-writes` + `confirm: true`)**
+
+- `send_mail` — send email to an npub/hex key, or an external address via the domain's SMTP bridge.
+- `claim_mailbox` — start claiming `you@mailstr.app`. Returns a **Lightning invoice to pay in
+  your own wallet** — the server holds no wallet, so it cannot pay it. Mail works once NIP-05
+  propagates.
+- `publish_mail_setup` — publish your profile (with the NIP-05 address) and the kind-10050
+  delivery-relay list senders read.
+
 ## Safety model
 
 Destructive / outward tools are **not registered** unless `--allow-writes` (or