# contextaiagent.xyz Memory Recall

> contextaiagent.xyz Memory Recall is a paid API for AI agents from contextaiagent.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Retrieve stored agent memories using semantic search against a query string, filtered by agent ID and optional tags

## Facts

- Endpoint: GET https://contextaiagent.xyz/api/memory/recall
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/contextaiagent-xyz-memory-recall-b53c56e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sHp4h4IPjyQWo5U3sCV96

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability contextaiagent-xyz-memory-recall-b53c56e4
```

Example prompt: Search my agent's memory for anything related to 'user onboarding preferences' — use agent ID 'agent-42' and return the top 5 most relevant results.

## When to prefer this

Use this endpoint when an AI agent needs to surface previously stored contextual memories using natural-language semantic similarity rather than exact key-value lookup. It is ideal for agents that persist knowledge across sessions and need to retrieve relevant past context to inform current responses. Prefer this over a direct database query when the retrieval intent is fuzzy or concept-based rather than ID-based.

## Known failure modes

- Missing required 'agent' or 'query' parameters returns a 400 error
- No matching memories found returns an empty result set
- Limit parameter outside 1-50 range causes validation error
- Invalid agent ID returns empty or error response
- Semantic search may return loosely related results if query is ambiguous
- Payment failure via x402 protocol blocks the request

## How this service works

Recall stored memories via semantic search

## Output

A ranked list of memory records semantically relevant to the query, associated with the specified agent. Each record likely includes the memory content, relevance score, associated tags, and metadata such as timestamp or memory ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "agent",
      "query"
     ],
     "properties": {
      "tags": {
       "type": "string",
       "description": "Comma-separated tags to filter results"
      },
      "agent": {
       "type": "string",
       "description": "Agent identifier"
      },
      "limit": {
       "type": "number",
       "maximum": 50,
       "minimum": 1,
       "description": "Max results to return"
      },
      "query": {
       "type": "string",
       "description": "Search query for semantic recall"
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contextaiagent-xyz-memory-recall-b53c56e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from contextaiagent.xyz](https://www.zero.xyz/host/contextaiagent.xyz/llms.txt)