Quickstart - Alshival.Ai

Prerequisites

DevTools account with an active API key
A target Resource URL copied from the DevTools Resource Details page (works for owned and shared resources)
One of:
- Python 3.9+
- Node.js 18+
- curl

Step 1: set environment variables

export ALSHIVAL_USERNAME='your_username'
export ALSHIVAL_API_KEY='your_api_key'
export ALSHIVAL_RESOURCE='https://alshival.dev/u/resource_owner_username/resources/resource_uuid/' # paste Resource URL from DevTools Resource Details
export ALSHIVAL_CLOUD_LEVEL='INFO'

ALSHIVAL_USERNAME is always your identity. ALSHIVAL_RESOURCE can point to your own resource or one shared with you.

Step 2: send your first log

Python SDK
Node.js SDK
curl

pip install git+https://github.com/Alshival-Ai/alshival.git@main

import alshival

alshival.log.info('service started')
alshival.log.alert('payment queue delay detected', extra={'queue': 'payments'})

npm install @alshival.ai/alshival

const alshival = require('@alshival.ai/alshival');

alshival.log.info('service started');
alshival.log.alert('payment queue delay detected', { extra: { queue: 'payments' } });

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ALSHIVAL_API_KEY" \
  -d '{
    "logs": [
      {
        "level": "info",
        "message": "service started",
        "ts": "2026-02-22T00:00:00+00:00"
      }
    ]
  }' \
  "${ALSHIVAL_RESOURCE%/}/logs/"

Step 3: connect MCP tools

For OpenAI Responses-compatible tool descriptors:

Python: use alshival.mcp and alshival.mcp.github
Node.js: use alshival.mcp and alshival.mcp.github

See /sdk/python and /sdk/nodejs for full examples.