---
title: "Developers and agents"
description: "Sites in the Woods for developers and AI agents: a quickstart, the JSON API and OpenAPI, the hosted MCP server, skills, limits, errors and the open-source CLI."
canonical: "https://sitesinthewoods.com/developers"
last-updated: "2026-11-19"
---
# Everything an agent needs, in one place.

Everything here works for a person at a terminal and for an AI agent acting for one. The docs and the files are public; a team's data needs a key from that team.

## Quickstart

1. [Sign in](https://sitesinthewoods.com/login) (an emailed code, no password) and add a site; an admin creates a key on the team's [API keys](https://sitesinthewoods.com/api-keys) page. It's shown once.
2. Keep it in the environment, never in a command or a chat: `export SITES_IN_THE_WOODS_API_KEY=sm_…`
3. Ask for your sites' status:

```
curl -H "Authorization: Bearer $SITES_IN_THE_WOODS_API_KEY" https://sitesinthewoods.com/api/status
```

Every answer is `{"data": …}` with `next_steps`, the calls that usually come next.

## The API

- **Reference**
  [Every route, parameter and field](https://sitesinthewoods.com/api/docs), also [as Markdown](https://sitesinthewoods.com/docs/api.md); the [OpenAPI 3.1 description](https://sitesinthewoods.com/openapi.json) to download; the [API catalog](https://sitesinthewoods.com/.well-known/api-catalog) (RFC 9727).
- **Keys and roles**
  [How keys work](https://sitesinthewoods.com/auth.md): viewer keys read; dismiss, check again, maintenance windows, pause need a member or admin key, on teams with 10 sites or more. Each operation in the OpenAPI names the lowest role it needs.
- **Errors**
  RFC 9457 problem details (`application/problem+json`), each with a code to branch on, what went wrong, what to do, and `next_steps`. [Every code](https://sitesinthewoods.com/api/docs#errors).
- **Limits**
  Requests a minute per key, by the team's sites: 60 on the free site, 300 from 2 sites, 1,000 from 25. Writes: 10 in 10 seconds. Every keyed answer carries `RateLimit-Policy` and `RateLimit` (IETF draft 11) with what's left; a 429 says when to retry.
- **Retries**
  Writes are idempotent: repeating one changes nothing more, so retrying after a timeout is safe.

## Versioning

The API is unversioned and changes only by adding routes and fields; one that has to go is announced at least 90 days ahead, on its responses, with Deprecation (RFC 9745) and Sunset (RFC 8594) headers and a Link to /developers#versioning (rel="deprecation").

## The MCP server

`https://sitesinthewoods.com/mcp`: one tool for each API route, with the same key. Its [docs](https://sitesinthewoods.com/api/docs#mcp), [server card](https://sitesinthewoods.com/mcp/server-card) and the [AI catalog](https://sitesinthewoods.com/.well-known/ard.json) say what it offers. [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=sites-in-the-woods&config=eyJ1cmwiOiJodHRwczovL3NpdGVzaW50aGV3b29kcy5jb20vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7ZW52OlNJVEVTX0lOX1RIRV9XT09EU19BUElfS0VZfSJ9fQ%3D%3D) (the key still comes from your environment).

Claude Code:

```
claude mcp add --transport http sites-in-the-woods https://sitesinthewoods.com/mcp --header "Authorization: Bearer $SITES_IN_THE_WOODS_API_KEY"
```

Cursor (~/.cursor/mcp.json):

```
{
  "mcpServers": {
    "sites-in-the-woods": {
      "url": "https://sitesinthewoods.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SITES_IN_THE_WOODS_API_KEY}"
      }
    }
  }
}
```

VS Code (.vscode/mcp.json):

```
{
  "inputs": [
    {
      "type": "promptString",
      "id": "sites-in-the-woods-key",
      "description": "Sites in the Woods API key",
      "password": true
    }
  ],
  "servers": {
    "sites-in-the-woods": {
      "type": "http",
      "url": "https://sitesinthewoods.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sites-in-the-woods-key}"
      }
    }
  }
}
```

## Agent skills

- [`sites-in-the-woods-status`](https://sitesinthewoods.com/.well-known/agent-skills/sites-in-the-woods-status/SKILL.md): Check whether a website that Sites in the Woods monitors in public is up, and see its recent outages, uptime and response times, from its public status page, data file and outage feed. Use when someone asks if one of these public sites is down, had an outage, or how reliable or fast it has been. Read-only, with no account or key. Not for a team's own private sites (use sites-in-the-woods-health with the team's key), and not for whether some other site or service is down (google.com, AWS, a site of your own): only sites on Sites in the Woods' public list.
- [`sites-in-the-woods-connect`](https://sitesinthewoods.com/.well-known/agent-skills/sites-in-the-woods-connect/SKILL.md): Set up an agent's access to a team's Sites in the Woods website monitoring: get an API key from the team's admin, keep it in an environment variable, add the hosted MCP server to Claude Code, Cursor or VS Code, and check the connection. Use when working with a team's Sites in the Woods monitoring for the first time, or when another Sites in the Woods skill can't reach its tools or gets a 401. Not for public status pages, which need no key (use sites-in-the-woods-status), and not for setting up other monitoring or alerting services (Pingdom, UptimeRobot, Datadog) or other MCP servers.
- [`sites-in-the-woods-health`](https://sitesinthewoods.com/.well-known/agent-skills/sites-in-the-woods-health/SKILL.md): Find out what's wrong with a team's websites and why, using the team's Sites in the Woods API key or MCP server: what's down now, open incidents with their likely causes, uptime, and domains or TLS certificates about to expire; and, with a Member or Admin key, ask for a check again or dismiss an incident as noise. Use when a team that monitors its sites with Sites in the Woods asks whether their sites are OK, what broke and why, or when a domain or certificate it watches expires. Not for a domain or certificate question without a Sites in the Woods account (a registrar, a one-off SSL check), maintenance windows or pausing a site (use sites-in-the-woods-maintenance), or public sites without a key (use sites-in-the-woods-status).
- [`sites-in-the-woods-maintenance`](https://sitesinthewoods.com/.well-known/agent-skills/sites-in-the-woods-maintenance/SKILL.md): Hold a team's Sites in the Woods alerts during a deploy or planned work with a maintenance window, end it, or pause and resume a site's checks, using the team's API key or MCP server. Use when someone says they're deploying or doing maintenance and wants alerts held, wants alerts back on, or wants a site's monitoring paused or resumed. Not for reading what's wrong (use sites-in-the-woods-health).

Indexed, with digests, at [`/.well-known/agent-skills/index.json`](https://sitesinthewoods.com/.well-known/agent-skills/index.json); [installing them](https://sitesinthewoods.com/skills). They're also in [our public repository](https://github.com/geeks-accelerator/sites-in-the-woods): `npx skills add geeks-accelerator/sites-in-the-woods`. That repository is an [Agent Plugin](https://agent-plugins.org) and a Claude Code plugin marketplace too (`/plugin marketplace add geeks-accelerator/sites-in-the-woods`), with an `AGENTS.md` for coding agents.

## Files for agents

- [llms.txt](https://sitesinthewoods.com/llms.txt), and [llms-full.txt](https://sitesinthewoods.com/llms-full.txt) with every page and API route.
- Every page as Markdown: add `.md` ([this page](https://sitesinthewoods.com/developers.md); the status page is [/index.md](https://sitesinthewoods.com/index.md)). Agents that send `Accept: text/markdown` get it at the page's own address.
- An [outage feed](https://sitesinthewoods.com/feed.xml) (Atom) for all public sites, and one per site; each public site's numbers as `/status/<slug>/data.json` and `data.csv`.
- Prices as [JSON](https://sitesinthewoods.com/pricing.json).

## Open source

[agent-ready-uptime](https://github.com/geeks-accelerator/agent-ready-uptime) is the checks this service runs, with a small self-hosted runner: `npx agent-ready-uptime init https://your.site`, then `npx agent-ready-uptime watch`. MIT, on npm. Our [agent and search readiness audit](https://github.com/geeks-accelerator/agent-and-search-readiness) scores a site once: `npx readiness-audit your.site`.

## For your coding agent

Paste this:

```
Read https://sitesinthewoods.com/llms.txt and https://sitesinthewoods.com/developers.md to learn Sites in the Woods' API and MCP server. My key is in the SITES_IN_THE_WOODS_API_KEY environment variable; never print it. Tell me which of my sites are down right now and which had outages in the last 7 days.
```

Without a key, an agent can still read every public status page: `https://sitesinthewoods.com/llms.txt` lists them.

Last updated November 19, 2026.
