# Spook MCP Server

[Spook](https://www.tryspook.com) is an SEO autopilot: it finds the queries a site can realistically win, then generates and publishes SEO articles targeting them.

This is Spook's official [Model Context Protocol](https://modelcontextprotocol.io/) server. It exposes **59 tools**:

- **Free SEO tools (no account needed)** — meta tag / schema / robots.txt / llms.txt generators, Google SERP preview, readability and keyword-density checkers, AI-crawler access checker, AEO checker, and more
- **Free AI tools (no account needed, rate-limited)** — blog keyword/outline/brief generators, SEO titles, meta descriptions, rewriter, summarizer, and more
- **`analyze_domain` (free)** — the quick-win queries any domain could rank for
- **Account tools (agent API key required)** — create and manage sites, list winnable opportunities, generate/publish SEO articles, read traffic metrics, toggle autopilot

Listed on the official MCP Registry as [`com.tryspook/spook`](https://registry.modelcontextprotocol.io/v0/servers?search=tryspook).

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=spook&config=eyJ1cmwiOiJodHRwczovL3d3dy50cnlzcG9vay5jb20vYXBpL21jcCJ9)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Spook_MCP-0098FF?logo=githubcopilot)](https://vscode.dev/redirect/mcp/install?name=spook&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//www.tryspook.com/api/mcp%22%7D)

## Hosted endpoint (recommended)

The server is hosted by Spook — no install needed:

```
https://www.tryspook.com/api/mcp
```

Transport: streamable HTTP. Authentication is optional: pass `Authorization: Bearer spook_agent_...` to unlock the account tools (generate a key in [Spook Settings](https://www.tryspook.com/settings) → Agent API).

### Claude Code

```bash
claude mcp add --transport http spook https://www.tryspook.com/api/mcp
# with an agent key:
claude mcp add --transport http spook https://www.tryspook.com/api/mcp \
  --header "Authorization: Bearer spook_agent_..."
```

Or install as a plugin (this repo is a Claude Code plugin marketplace):

```
/plugin marketplace add VictorKildahl/spook-mcp
/plugin install spook@spook
```

### Claude.ai / Claude Desktop (custom connector)

Settings → Connectors → Add custom connector → URL `https://www.tryspook.com/api/mcp`.

### Cursor

One click: [Add to Cursor](https://cursor.com/en/install-mcp?name=spook&config=eyJ1cmwiOiJodHRwczovL3d3dy50cnlzcG9vay5jb20vYXBpL21jcCJ9), or in `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "spook": {
      "url": "https://www.tryspook.com/api/mcp"
    }
  }
}
```

### VS Code / GitHub Copilot

One click: [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=spook&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//www.tryspook.com/api/mcp%22%7D), or add to your user `mcp.json` (Command Palette → "MCP: Open User Configuration"):

```json
{
  "servers": {
    "spook": {
      "type": "http",
      "url": "https://www.tryspook.com/api/mcp"
    }
  }
}
```

### OpenAI Codex CLI

```bash
codex mcp add spook -- npx -y github:VictorKildahl/spook-mcp
```

Or in `~/.codex/config.toml`:

```toml
[mcp_servers.spook]
command = "npx"
args = ["-y", "github:VictorKildahl/spook-mcp"]
```

## Stdio bridge (this repo)

For stdio-only MCP clients, this repo ships a zero-dependency bridge that forwards newline-delimited JSON-RPC from stdin to the hosted server:

```bash
npx github:VictorKildahl/spook-mcp
```

Or in an MCP client config:

```json
{
  "mcpServers": {
    "spook": {
      "command": "npx",
      "args": ["-y", "github:VictorKildahl/spook-mcp"],
      "env": { "SPOOK_AGENT_KEY": "spook_agent_..." }
    }
  }
}
```

Environment variables:

| Variable | Purpose |
|---|---|
| `SPOOK_AGENT_KEY` | Optional. Agent API key (`spook_agent_...`) for the account tools. |
| `SPOOK_MCP_URL` | Optional. Override the upstream endpoint (defaults to the hosted server). |

## Other machine-readable surfaces

- `https://www.tryspook.com/openapi.json` — REST agent API (OpenAPI)
- `https://www.tryspook.com/llms.txt` — site overview for LLMs
- `https://www.tryspook.com/.well-known/agents.json` — agent capability manifest

## Privacy & terms

- [Privacy policy](https://www.tryspook.com/privacy)
- [Terms](https://www.tryspook.com/terms)

Support: victor.petersen2@gmail.com