Troubleshooting

401 Unauthorized

Use Authorization: Bearer mn_… or header x-api-key: mn_…
Key must be active (not revoked) — check console → Settings → API keys
No extra spaces when pasting the key

402 Payment required / quota

Daily read/write caps for your plan — GET /v1/usage/today
Upgrade via console billing (PayU checkout)

429 Rate limited

Per-workspace concurrency or rate limits — retry with backoff (SDK does this automatically on REST)

Search returns nothing

Check	Action
Wrong user/namespace	Match ingest `user_id` and `namespace`
Too soon	Retry after 2–5s on first memory
Query mismatch	Try keywords from the stored sentence
`min_score` too high	Lower or omit
Degraded entitlements	Response `ENTITLEMENT_DEGRADED` — use `search_mode: "keyword"` temporarily

See DEBUGGING.md.

`MISSING_OWNER_ID` (SDK)

Provide ownerId (or userId) on remember / recall / addMemory / search. The simplified MemoryNode class defaults to MEMORYNODE_USER_ID or default-user.

MCP search differs from REST

Default SDK transport is hybrid on MemoryNodeClient; MemoryNode uses rest only. For identical behavior, set transport: "rest" or use the same query shape.

Local Worker vs production

Local: BASE_URL=http://127.0.0.1:8787 and a dev API key
Production: https://api.memorynode.ai — MemoryNode constructor sets this automatically

Still stuck?

Note x-request-id from the failing call
Open DEBUGGING.md
Contact support with request ID and workspace (no secrets)