Skip to main content

​
Logs not appearing in timeline

  • Verify ALSHIVAL_USERNAME, ALSHIVAL_API_KEY, and ALSHIVAL_RESOURCE.
  • Confirm the target resource belongs to the expected account context.
  • Enable ALSHIVAL_DEBUG=true temporarily for SDK diagnostics.
  • Run a direct curl ingest call to isolate SDK vs network issues.

​
MCP tools are missing

  • Send X-User-Username with X-API-Key.
  • Check tools/list via curl against https://mcp.alshival.ai/mcp/.
  • Confirm account tier includes expected capabilities.
  • For GitHub MCP, confirm GitHub account is connected.

​
GitHub MCP auth failures

Common causes:
  • Missing or mismatched X-User-Username
  • Stale/revoked key
  • No active GitHub connection in DevTools

​
Minimal health checks

python -m pip show alshival

curl -sS https://mcp.alshival.ai/mcp/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ALSHIVAL_API_KEY" \
  -H "X-User-Username: $ALSHIVAL_USERNAME" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'