For AI agents

Build with Vartio from any AI agent.

Vartio exposes a stable REST API and machine-readable docs. Drop the Vartio API into Claude, ChatGPT, Cursor, Codex, or any other agent and it can create monitors, fetch statuses, and configure alerts in a single tool call.

/llms.txt /llms-full.txt OpenAPI 3.0 spec

Step 1

Get an API key

Log in to Vartio, go to Settings → API keys, and click “Create API key”. The token starts with vk_ and is shown once. Pass it as a Bearer token on every request.

Open Settings → API keys

Treat API keys like passwords. They are scoped to a single organization and have no expiry by default.

Step 2

Create a monitor

Required fields: name, type, and url. Type accepts http, ssl, dns, ping, tcp, udp, or multi_step.

curl -X POST https://api.vartio.dev/api/v1/monitors \
  -H "Authorization: Bearer vk_REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API",
    "type": "http",
    "url": "https://api.example.com/health",
    "interval_seconds": 60,
    "expected_status": 200
  }'

Step 3

List monitors and statuses

The list endpoint returns each monitor enriched with current_status, last_response_time_ms, and a 30-day uptime percentage. Single-call dashboard data.

curl https://api.vartio.dev/api/v1/monitors \
  -H "Authorization: Bearer vk_REPLACE_ME"

Bonus

Use the public catalogue (no auth)

Vartio maintains 1000+ public service statuses. Agents can answer “is OpenAI down?” or “is GitHub down?” with one unauthenticated GET. AI triage is also available for human-readable diagnostics.

# Catalogue of 1000+ services, no auth needed
curl https://api.vartio.dev/public/services/openai

# Force a fresh check (rate-limited 6/min/IP)
curl https://api.vartio.dev/public/services/openai/live-check

# AI-powered triage
curl https://api.vartio.dev/public/services/openai/triage

Plug Vartio into your agent

Point your agent at one of these and let it discover the rest. Thellms.txt file follows the llmstxt.org convention.

https://api.vartio.dev/llms.txt — short index pointing at OpenAPI, this guide, and the public catalogue
https://api.vartio.dev/llms-full.txt — long-form reference with auth, common patterns, and copy-paste cURL examples
https://api.vartio.dev/api/openapi.yaml — canonical OpenAPI 3.0 spec for tool generation

Coming soon

A first-party MCP server so Claude Desktop, Cursor, and Codex pick up Vartio as a tool with zero configuration. Want early access? Get in touch.