Docs MCP

Troubleshooting

Symptoms, likely causes and fixes.

#Common problems

SymptomLikely causeFix
Client shows no toolsWrong URL or transportUse the /mcp URL and HTTP transport
401 on every callToken missing, expired or revokedRe-create the token; check header syntax
recall returns nothingJob not completed, or memory private to another identityCheck memory_status; check visibility
forget failsTool disabled or record authored by someone elseEnable for the token or delete via API
429 errorsProject rate limit shared with your backendSpread 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.