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

# MCP servers

> Attach DevTools MCP endpoints to your own agent stack

DevTools subscribers have access to two MCP servers:

* `alshival-mcp`: `https://mcp.alshival.ai/mcp/`
* `github-mcp`: `https://mcp.alshival.ai/github/`

## Auth requirements

* `X-API-Key`: required
* `X-User-Username` (recommended) or `X-User-Email`: user-scoped identity
* GitHub MCP requires a connected GitHub account in DevTools

## Tool descriptor examples

<Tabs>
  <Tab title="Python SDK helper">
    ```python theme={null}
    import alshival

    tools = [
        alshival.mcp,
        alshival.mcp.github,
    ]
    ```
  </Tab>

  <Tab title="Node.js SDK helper">
    ```javascript theme={null}
    const alshival = require('@alshival.ai/alshival');

    const tools = [
      alshival.mcp,
      alshival.mcp.github,
    ];
    ```
  </Tab>

  <Tab title="Raw tool JSON">
    ```json theme={null}
    {
      "type": "mcp",
      "server_label": "alshival-mcp",
      "server_url": "https://mcp.alshival.ai/mcp/",
      "require_approval": "never",
      "headers": {
        "x-api-key": "your_devtools_api_key",
        "x-user-username": "your_username"
      }
    }
    ```
  </Tab>
</Tabs>

## Manual health check

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