# Statuscake

```json
{
  "name": "Statuscake",
  "slug": "statuscake",
  "url": "https://composio.dev/toolkits/statuscake",
  "markdown_url": "https://composio.dev/toolkits/statuscake.md",
  "logo_url": "https://logos.composio.dev/api/statuscake",
  "categories": [
    "developer tools & devops"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:27:10.885Z"
}
```

![Statuscake logo](https://logos.composio.dev/api/statuscake)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Statuscake MCP or direct API to monitor uptime, check SSL certificates, trigger alerts, and retrieve historical incidents through natural language.

## Summary

Statuscake is a website monitoring platform offering uptime, page speed, and SSL monitoring. It helps you catch outages and performance issues before your users do.

## Categories

- developer tools & devops

## Toolkit Details

- Tools: 30

## Images

- Logo: https://logos.composio.dev/api/statuscake

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Statuscake.
  - Setup:
    - Configure Api Key credentials for Statuscake.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List all uptime monitoring tests for my sites
- Show details for SSL check on my domain
- Retrieve all recent pagespeed test results
- List all contact groups in my StatusCake account

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `STATUSCAKE_CREATE_CONTACT_GROUP` | Create Contact Group | Tool to create a contact group for alert notifications in StatusCake. Use when you need to set up a new group of notification recipients for monitoring alerts. The group can include email addresses, mobile numbers, integrations, and a webhook URL. At minimum, provide a name; other notification methods are optional. |
| `STATUSCAKE_CREATE_HEARTBEAT_TEST` | Create Heartbeat Test | Tool to create a heartbeat check in StatusCake. Use when you need to set up monitoring for services that send periodic pings. A heartbeat check monitors whether your service is sending regular "heartbeat" pings to StatusCake. If the service fails to send a ping within the specified period, StatusCake will alert you through the configured contact groups. This is ideal for monitoring cron jobs, backup processes, or any scheduled tasks that should run at regular intervals. |
| `STATUSCAKE_CREATE_PAGESPEED_TEST` | Create PageSpeed Test | Tool to create a new pagespeed check in StatusCake. Use when you need to set up performance monitoring for a website URL with specific check frequency and region. Returns the ID of the newly created test. |
| `STATUSCAKE_CREATE_UPTIME_TEST` | Create Uptime Test | Tool to create a new uptime monitoring check in StatusCake. Use when you need to set up monitoring for a website or server. Supports various check types including HTTP, PING, TCP, DNS, and more. Returns the ID of the newly created test. |
| `STATUSCAKE_DELETE_CONTACT_GROUP` | Delete Contact Group | Tool to delete a contact group. Use when you need to remove an existing contact group by its ID after confirming its existence. |
| `STATUSCAKE_DELETE_HEARTBEAT_TEST` | Delete Heartbeat Test | Permanently deletes a StatusCake heartbeat check. Use this to remove heartbeat monitoring tests that are no longer needed. This operation is irreversible - the heartbeat check and all its historical data will be removed. |
| `STATUSCAKE_DELETE_PAGESPEED_TEST` | Delete PageSpeed Test | Permanently deletes a StatusCake PageSpeed test. Use this to remove PageSpeed tests that are no longer needed. This operation is irreversible - the test and all its historical data will be removed. The operation is idempotent - deleting an already-deleted test will still return success. |
| `STATUSCAKE_DELETE_SSL_TEST` | Delete SSL Test | Tool to delete an SSL check with the given ID. Use when you need to permanently remove an SSL monitoring test from StatusCake. |
| `STATUSCAKE_DELETE_TEST` | Delete Test | Permanently deletes a StatusCake uptime monitoring test. Use this to remove tests that are no longer needed. This operation is irreversible - the test and all its historical data will be removed. The operation is idempotent - deleting an already-deleted test will still return success. |
| `STATUSCAKE_GET_ALL_CONTACT_GROUPS` | Get All Contact Groups | Retrieves a paginated list of contact groups for alert notifications. Contact groups define who receives alerts when monitoring tests fail. Returns group names, email addresses, mobile numbers, and integrations. Use this to find existing contact groups before creating new ones or to verify notification recipients. |
| `STATUSCAKE_GET_ALL_LOCATIONS` | Get All Monitoring Locations | Retrieves all available uptime monitoring server locations from StatusCake. Use this tool to: - List all monitoring locations to show users available regions - Get region_code values needed when creating or updating uptime checks - Check the current status of monitoring servers - Get IP addresses of monitoring servers for firewall whitelisting Returns ~150 monitoring locations across 30+ countries with their region codes, IP addresses, and availability status. |
| `STATUSCAKE_GET_ALL_PAGESPEED_TESTS` | Get All PageSpeed Tests | Tool to retrieve all PageSpeed tests. Use when you need to list existing PageSpeed performance tests in StatusCake after authenticating. |
| `STATUSCAKE_GET_ALL_TESTS` | Get All Tests | Tool to retrieve a list of all tests. Use when you need to list your monitoring tests in StatusCake. Results reflect only pre-configured tests; missing results or stale check data do not indicate real-time downtime. |
| `STATUSCAKE_GET_CONTACT_GROUP_DETAILS` | Get Contact Group Details | Tool to retrieve details of a specific contact group. Use when you need group metadata by providing its ID. Example: "Get details for contact group 12345". |
| `STATUSCAKE_GET_HEARTBEAT_CHECKS` | Get Heartbeat Checks | Tool to list heartbeat checks. Use when you need to retrieve all heartbeat monitoring tests for your account. |
| `STATUSCAKE_GET_HEARTBEAT_TEST` | Get Heartbeat Test | Tool to retrieve details of a specific heartbeat check. Use when you need configuration and status of a heartbeat test by providing its ID. Example: "Get heartbeat test details for 7884186". |
| `STATUSCAKE_GET_PAGESPEED_TEST` | Get Pagespeed Test | Tool to retrieve details of a specific pagespeed check. Use when you need configuration and status of a pagespeed test by providing its ID. Example: "Get pagespeed test details for 122582". |
| `STATUSCAKE_GET_SSL_CHECK_DETAILS` | Get SSL Check Details | Tool to retrieve details of a specific SSL check. Use when you need configuration and status of an SSL test by providing its ID. Example: "Get SSL check details for 123". |
| `STATUSCAKE_GET_SSL_CHECKS` | Get SSL Checks | Retrieve a paginated list of SSL checks configured in your StatusCake account. Use this action to: - List all SSL certificate monitors - Check certificate statuses across your monitored domains - Review SSL check configurations and alert settings - Get pagination metadata for navigating large result sets Returns SSL check details including certificate validity dates, cipher information, security scores, and alert configuration. |
| `STATUSCAKE_GET_UPTIME_TEST` | Get Uptime Test | Tool to retrieve details of a specific uptime test. Use when you need configuration and status of an uptime check by providing its ID. Example: "Get uptime test details for 7884184". |
| `STATUSCAKE_LIST_PAGESPEED_MONITORING_LOCATIONS` | List PageSpeed Monitoring Locations | Retrieves all available PageSpeed monitoring server locations from StatusCake. Use when you need to list regions for PageSpeed test configuration or check server availability. |
| `STATUSCAKE_LIST_PAGESPEED_TEST_HISTORY` | List Pagespeed Test History | Tool to retrieve pagespeed check history for a given test ID. Use when you need to analyze historical performance data for a specific pagespeed test. |
| `STATUSCAKE_LIST_UPTIME_TEST_ALERTS` | List Uptime Test Alerts | Tool to retrieve a list of alerts for a specific uptime check. Use when you need to view historical alerts and status changes for an uptime test. |
| `STATUSCAKE_LIST_UPTIME_TEST_HISTORY` | List Uptime Test History | Tool to retrieve uptime check history for a given test ID. Use when you need to view historical results of uptime monitoring checks. Supports pagination and time-based filtering. |
| `STATUSCAKE_LIST_UPTIME_TEST_PERIODS` | List Uptime Test Periods | Tool to retrieve a list of uptime check periods for a specific test. Use when you need to view the historical up/down periods for an uptime check. |
| `STATUSCAKE_UPDATE_CONTACT_GROUP` | Update Contact Group | Updates an existing contact group's configuration in StatusCake. Use this tool when you need to modify the name, email addresses, mobile numbers, or integrations of an existing contact group. At least one field besides contact_group_id should be provided to make meaningful changes. The API uses form-urlencoded data format and returns 204 No Content on success, so the action fetches the updated group details after a successful update. |
| `STATUSCAKE_UPDATE_HEARTBEAT_TEST` | Update Heartbeat Test | Tool to update an existing heartbeat check with new parameters. Use when you need to modify the name, monitoring period, tags, contact groups, host, or pause status of a heartbeat check. |
| `STATUSCAKE_UPDATE_PAGESPEED_TEST` | Update Pagespeed Test | Updates a pagespeed check with the given parameters. Use when you need to modify the configuration of an existing pagespeed monitoring test in StatusCake. At least one field besides test_id should be provided to make meaningful changes. |
| `STATUSCAKE_UPDATE_SSL_TEST` | Update SSL Test | Tool to update an SSL check with new configuration parameters. Use when modifying SSL monitoring settings like check frequency, alert preferences, or contact groups. Example: "Update SSL check 123 to check every hour". |
| `STATUSCAKE_UPDATE_UPTIME_TEST` | Update Uptime Test | Updates an uptime check with the given parameters. Use when you need to modify configuration of an existing uptime monitoring test such as check frequency, URL, tags, contact groups, or other settings. At least one field besides test_id should be provided to make meaningful changes. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Statuscake Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Statuscake actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List all uptime monitoring tests for my sites'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all uptime monitoring tests for my sites'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Statuscake tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List all uptime monitoring tests')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'List all uptime monitoring tests' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Statuscake Integration

- Supports both Statuscake MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Statuscake data

### 2. Managed Auth

- Built-in API key handling with secure vault storage
- Central place to manage, scope, and revoke Statuscake access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Statuscake
- Scoped, least privilege access to Statuscake resources
- Full audit trail of agent actions to support review and compliance

## Use Statuscake with any AI Agent Framework

Choose a framework you want to connect Statuscake with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/statuscake/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/statuscake/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/statuscake/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/statuscake/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/statuscake/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/statuscake/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/statuscake/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/statuscake/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/statuscake/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/statuscake/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/statuscake/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/statuscake/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/statuscake/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/statuscake/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/statuscake/framework/autogen)

## Related Toolkits

- [Supabase](https://composio.dev/toolkits/supabase) - Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.
- [Codeinterpreter](https://composio.dev/toolkits/codeinterpreter) - Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.
- [GitHub](https://composio.dev/toolkits/github) - GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.
- [Ably](https://composio.dev/toolkits/ably) - Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences.
- [Abuselpdb](https://composio.dev/toolkits/abuselpdb) - Abuselpdb is a central database for reporting and checking IPs linked to malicious online activity. Use it to quickly identify and report suspicious or abusive IP addresses.
- [Alchemy](https://composio.dev/toolkits/alchemy) - Alchemy is a blockchain development platform offering APIs and tools for Ethereum apps. It simplifies building and scaling Web3 projects with robust infrastructure.
- [Algolia](https://composio.dev/toolkits/algolia) - Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure.
- [Anchor browser](https://composio.dev/toolkits/anchor_browser) - Anchor browser is a developer platform for AI-powered web automation. It transforms complex browser actions into easy API endpoints for streamlined web interaction.
- [Apiflash](https://composio.dev/toolkits/apiflash) - Apiflash is a website screenshot API for programmatically capturing web pages. It delivers high-quality screenshots on demand for automation, monitoring, or reporting.
- [Apiverve](https://composio.dev/toolkits/apiverve) - Apiverve delivers a suite of powerful APIs that simplify integration for developers. It's designed for reliability and scalability so you can build faster, smarter applications without the integration headache.
- [Appcircle](https://composio.dev/toolkits/appcircle) - Appcircle is an enterprise-grade mobile CI/CD platform for building, testing, and publishing mobile apps. It streamlines mobile DevOps so teams ship faster and with more confidence.
- [Appdrag](https://composio.dev/toolkits/appdrag) - Appdrag is a cloud platform for building websites, APIs, and databases with drag-and-drop tools and code editing. It accelerates development and iteration by combining hosting, database management, and low-code features in one place.
- [Appveyor](https://composio.dev/toolkits/appveyor) - AppVeyor is a cloud-based continuous integration service for building, testing, and deploying applications. It helps developers automate and streamline their software delivery pipelines.
- [Backendless](https://composio.dev/toolkits/backendless) - Backendless is a backend-as-a-service platform for mobile and web apps, offering database, file storage, user authentication, and APIs. It helps developers ship scalable applications faster without managing server infrastructure.
- [Baserow](https://composio.dev/toolkits/baserow) - Baserow is an open-source no-code database platform for building collaborative data apps. It makes it easy for teams to organize data and automate workflows without writing code.
- [Bench](https://composio.dev/toolkits/bench) - Bench is a benchmarking tool for automated performance measurement and analysis. It helps you quickly evaluate, compare, and track your systems or workflows.
- [Better stack](https://composio.dev/toolkits/better_stack) - Better Stack is a monitoring, logging, and incident management solution for apps and services. It helps teams ensure application reliability and performance with real-time insights.
- [Bitbucket](https://composio.dev/toolkits/bitbucket) - Bitbucket is a Git-based code hosting and collaboration platform for teams. It enables secure repository management and streamlined code reviews.
- [Blazemeter](https://composio.dev/toolkits/blazemeter) - Blazemeter is a continuous testing platform for web and mobile app performance. It empowers teams to automate and analyze large-scale tests with ease.
- [Blocknative](https://composio.dev/toolkits/blocknative) - Blocknative delivers real-time mempool monitoring and transaction management for public blockchains. Instantly track pending transactions and optimize blockchain interactions with live data.

## Frequently Asked Questions

### Do I need my own developer credentials to use Statuscake with Composio?

Yes, Statuscake requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)