DevTools Documentation

DevTools Docs

Cloud logging, MCP integrations, frontend tooling, and SSH workflows for production DevTools teams.

MCP Access
Cloud Logger
Frontend Tools
SSH Ready
DevTools Documentation Hub
Critical Reference

DevTools gives each subscriber a production-ready toolkit: cloud logging, MCP servers, frontend workflows, and SSH-based operations. This docs section is organized around how teams actually ship: authenticate, connect, integrate with agents, then monitor in production.

Included MCP Servers
Your DevTools account can access both MCP endpoints: alshival_mcp and github-mcp.
Open MCP Docs
SDK + Direct HTTP
Use the Python SDK and Node.js SDK today, or use curl directly for raw HTTP integrations.
Open SDK Docs
Quick Start (Python / Node.js / curl)

Both examples write to the same resource timeline. Copy the Resource URL from the DevTools Resource Details page and set it as ALSHIVAL_RESOURCE (works for owned and shared resources).

import os
import logging
import alshival

logging.basicConfig(level=logging.INFO)

alshival.configure(
    username='your_username',
    api_key='your_api_key',
    resource=os.getenv('ALSHIVAL_RESOURCE'),
    base_url='https://alshival.dev',
)

alshival.log.info('service started')
alshival.log.warning('cache warmup delayed', extra={'service': 'api'})
const alshival = require('@alshival.ai/alshival');

alshival.configure({
  username: 'your_username',
  apiKey: 'your_api_key',
  resource: process.env.ALSHIVAL_RESOURCE,
  baseUrl: 'https://alshival.dev',
  cloudLevel: 'INFO',
});

alshival.log.info('service started');
alshival.log.warning('cache warmup delayed', { extra: { service: 'api' } });
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-20T00:00:00+00:00"
      }
    ]
  }' \
  "${ALSHIVAL_RESOURCE%/}/logs/"
Use MCP with Other Agents

Attach DevTools MCP servers to OpenAI Responses API tools, or any client that supports MCP tool descriptors.

import alshival
from openai import OpenAI

client = OpenAI()

tools = [
  alshival.mcp,
  alshival.mcp.github,
]

response = client.responses.create(
  model='gpt-5.2',
  input='Review my repo and summarize open deployment risks.',
  tools=tools,
)

Requires OPENAI_API_KEY, ALSHIVAL_API_KEY, and ALSHIVAL_USERNAME (or ALSHIVAL_EMAIL) in your environment.

MCP Setup Guide
Frontend + SSH Workflows

DevTools supports frontend shipping and SSH-driven operations. Keep deployment scripts, keys, and diagnostics in one place.

  • Frontend pages and profile tooling in the DevTools UI.
  • Resource-centric SSH workflows and key management.
  • Cloud logs + resource health views for fast triage.
Frontend & SSH Docs
Documentation Map
Platform
API keys, resources, logging, MCP servers, frontend + SSH.
SDK + HTTP
Python and Node.js SDK workflows plus direct curl reference.
Troubleshooting
Auth, MCP, ingestion, and runtime diagnostics.