Troubleshooting
Solutions to common issues when integrating with Rembr.
Authentication Issues
"Invalid or revoked API key"
Cause: The API key is incorrect, expired, or has been revoked.
Solution:
- • Verify the key starts with
mb_live_ - • Check the key hasn't expired in your dashboard
- • Ensure you're using the
x-api-keyheader (not Bearer auth) - • Generate a new key if needed
"Rate limit exceeded"
Cause: Too many requests in a short period.
Solution: Implement exponential backoff. Check your plan's rate limits in the dashboard. Consider upgrading if you need higher limits.
Memory Operations
Search returns no results
Possible causes:
- • Similarity threshold too high — try lowering to 0.5
- • Searching wrong category — remove category filter or check spelling
- • Memories haven't been indexed yet — wait a few seconds after storing
- • Query is too different from stored content — try different phrasing
"Invalid category" error
Cause: Category name doesn't match allowed values.
Solution: Use one of the valid categories: facts, preferences, conversations, projects, learning, goals, context, reminders, patterns, decisions, workflows, insights
Slow embedding generation
Cause: Embedding model processing backlog.
Solution: Embeddings are generated asynchronously. For immediate search, wait a few seconds after storing. Text search works immediately without embeddings.
MCP Connection
MCP client can't connect
Checklist:
- • Endpoint URL should be
https://rembr.ai/mcp - • Include header:
Accept: application/json, text/event-stream - • Include header:
x-api-key: your_key - • Use POST method for all MCP requests
Tool not found error
Cause: Tool name doesn't match exactly.
Solution: Tool names are case-sensitive. Use search_memory (singular), not search_memories. See the full MCP Tools Reference.
Plan Limits
"Memory limit reached"
Cause: Your plan's memory storage limit has been exceeded.
Solution:
- • Archive or delete old memories you no longer need
- • Use
get_statsto check current usage - • Upgrade your plan for more storage