Integrate Your Agent

Configure your AI agents to automatically report issues when services fail

Quick Start

Get your agent reporting issues in under 5 minutes

Get an API Key

Add MCP Server

Use our MCP server or call the API directly

Check Status & Report

Agents check service status and report failures

Your API Keys

API Keys Required

Create a free account to generate API keys for your agents. Read the documentation below to learn how to integrate.

Integration Guide

WhatsDownAI Skill via skills.sh

The easiest way to integrate - install with a single command for any AI agent

Skills are reusable capabilities for AI agents. Install WhatsDownAI and your agent automatically knows how to check service status and report issues.

Install from skills.sh

Install the WhatsDownAI skill with the skills CLI:

npx skills add whatsdownai/skills

Works with Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, and 15+ other agents.

What the Skill Provides

Once installed, your AI agent gains these capabilities:

Pre-flight Status Checks

Check if AI services are operational before making API calls

Automatic Issue Reporting

Report failures to help the community track outages

Fallback Recommendations

Get suggestions for alternative services during outages

Using the Skill

Your agent will automatically use WhatsDownAI when appropriate. You can also explicitly invoke it:

Check before calling an API:

"Check if OpenAI is operational before making the API call"

Report an issue:

"The Anthropic API timed out. Report this to WhatsDownAI."

Check all services:

"Which AI services are currently having issues?"

Configuration

Set your API key as an environment variable for authenticated requests:

export WHATSDOWNAI_API_KEY="your_api_key_here"

Browse skills.sh View on GitHub Skills Docs

Install via Skills.sh

For agents that support Vercel Skills, install WhatsDownAI with a single command

Quick Install

Add WhatsDownAI monitoring to any agent that supports skills

Install the main skill

npx skills add whatsdownai/whatsdownai

Or install individual skills

Status checking only:

npx skills add whatsdownai/whatsdownai --skill check-ai-service-status

Issue reporting only:

npx skills add whatsdownai/whatsdownai --skill report-ai-service-issue

Available Skills

whatsdownai

Complete skill

Both status checking and issue reporting in one skill

check-ai-service-status

Pre-flight checks

Check if services are operational before making API calls

report-ai-service-issue

Error reporting

Report issues when you encounter errors with AI services

Setup for Popular Coding Agents

Instructions for integrating WhatsDownAI with the most popular AI coding assistants

Claude Code (Anthropic)

Integrate WhatsDownAI with Claude Code CLI

Recommended: Use the MCP server for full status checking + reporting capabilities

1. Add MCP Server (Recommended)

Add WhatsDownAI to your Claude Code MCP settings for status checking and issue reporting:

{
  "mcpServers": {
    "whatsdownai": {
      "command": "npx",
      "args": ["-y", "@agent-up/mcp-server"],
      "env": {
        "WHATSDOWNAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. Add to CLAUDE.md

Add instructions to your project's CLAUDE.md:

# WhatsDownAI Integration

You have access to WhatsDownAI tools via MCP for monitoring AI service health:

## Before Making External API Calls
Use check_service_status to verify services are operational before calling them.
Example: check_service_status(service="openai")

## When Encountering Errors
Report issues using report_service_issue to help detect outages early.
Example: report_service_issue(service="openai", error_type="timeout", description="API timeout after 30s")

## Available Services
Model providers: openai, anthropic, mistral, cohere, groq, deepseek, perplexity
MCP servers: github-mcp, slack-mcp, stripe-mcp, cloudflare-mcp, neon-mcp

Best Practices

Avoid Duplicate Reports

Implement rate limiting on your side - don't report the same issue more than once per minute. Our API will deduplicate, but it's better to handle client-side.

Include Metadata

Add your agent name, version, and any relevant context to metadata. This helps identify patterns across different agent implementations.

Check Status First

Before making API calls, optionally check if a service is already experiencing issues. This can help you fail fast or use fallbacks.

Secure Your API Key

Store your API key in environment variables, never in code. Rotate keys periodically and revoke any that may have been exposed.