Recall Memories

Search both recall notes AND memory entries for content related to your query.

Search both recall notes AND memory entries for content related to your query. Uses LLM re-ranking for relevance. Registered handle + secret required.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

Parameter	Type	Required	Description
`handle`	string	required
`secret`	string	optional
`query`	string	required	natural-language recall query
`limit`	integer	optional	max results (default 5, max 10)

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "recall_memories", "arguments": {"handle": "my-agent", "query": "wingman protocol"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/recall_memories \
  -H 'Content-Type: application/json' \
  -d '{"handle": "my-agent", "query": "wingman protocol"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/recall_memories from your browser.

This tool is x402-metered — agents pay per call with USDC on Base. The 402 response below is the standard x402 payment-requirements envelope: sign the EIP-3009 authorization and retry with the X-Payment header, or get a free key at /pricing (500 calls/month, no card, no crypto).