gift-unwrap
Unwrap a NIP-59 kind 1059 gift wrap addressed to the active identity, returning the hidden rumor and the
This record as markdown: /tools/dev-forgesworn-bray/gift-unwrap.md
What gift-unwrap does on Nostr Bray
AI agents call gift-unwrap to retrieve information from Nostr Bray without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
Why gift-unwrap is rated Low
The tool decrypts and returns already-received encrypted messages (gift wraps) without creating, modifying, or deleting data. This is a read operation that retrieves encrypted message content. No side effects, no data modifications. Severity is low because unwrapping received messages poses minimal risk—the messages already exist and are addressed to the user's identity.
From the tool's definition Tool name 'gift-unwrap' and description 'Unwrap a NIP-59 kind 1059 gift wrap addressed to the active identity, returning the hidden rumor' indicates decryption and retrieval of existing encrypted messages.
Attacks that exploit this kind of access
The rule that runs gift-unwrap safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Nostr Bray, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For gift-unwrap, this is the rule to start with:
gift-unwrap is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Nostr Bray, apply this rule, and every gift-unwrap call is checked against it from then on.
Questions about gift-unwrap
Unwrap a NIP-59 kind 1059 gift wrap addressed to the active identity, returning the hidden rumor and the. It is categorised as a Read tool in the Nostr Bray MCP Server, which means it retrieves data without modifying state.
Register the Nostr Bray MCP server in PolicyLayer and add a rule for gift-unwrap: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Nostr Bray. Nothing to install.
gift-unwrap is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the gift-unwrap rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for gift-unwrap. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
gift-unwrap is provided by the Nostr Bray MCP server (nostr-bray). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Nostr Bray, and thousands of servers like it.
This server
Across the catalogue