Docs MCP
Troubleshooting
Symptoms, likely causes and fixes.
#Common problems
| Symptom | Likely cause | Fix |
|---|---|---|
| Client shows no tools | Wrong URL or transport | Use the /mcp URL and HTTP transport |
| 401 on every call | Token missing, expired or revoked | Re-create the token; check header syntax |
| recall returns nothing | Job not completed, or memory private to another identity | Check memory_status; check visibility |
| forget fails | Tool disabled or record authored by someone else | Enable for the token or delete via API |
| 429 errors | Project rate limit shared with your backend | Spread load or move to a higher plan |
#Check the token directly
Rule out the client by calling the server yourself. A successful tools/list returns the enabled tools.
List tools
curl -s -X POST "https://YOUR-AULD-HOST/mcp" \
-H "Authorization: Bearer $AULD_MCP_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Illustrative interface example · replace the host and key placeholders
#Still stuck?
Send the requestId from the error to support@auld.app.