> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alshival.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Resolve common auth, logging, and MCP issues

## 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

```bash theme={null}
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":{}}'
```