Live MCP toolmemory

Search Memory

Full-text search over YOUR memory values using FTS5.

Full-text search over YOUR memory values using FTS5. Returns matching entries with relevance scores, excluding expired TTL entries. Scoped to memory you own — registered handle + secret required. Omit namespace to search all of your own memory.

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
`namespace`	string	optional	namespace to search within (omit to search all of yours)
`query`	string	required	FTS5 search terms (porter stemmer, unicode61 tokenizer)
`limit`	integer	optional	max results (default 20, max 100)

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": "search_memory", "arguments": {"handle": "my-agent", "query": "wingman protocol"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/search_memory \
  -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/search_memory 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).