# Event Alerts MCP Server

A public, read-only [Model Context Protocol](https://modelcontextprotocol.io) server that lets AI assistants look up Minecraft events, partner servers, and player profiles on Event Alerts.

## Overview

- Endpoint: `https://eventalerts.gg/api/mcp`
- Transport: streamable HTTP (stateless)
- Authentication: none
- Access: read-only; every tool is annotated with `readOnlyHint: true` and `destructiveHint: false`
- Server card: https://eventalerts.gg/.well-known/mcp/server-card.json

## Tools

### `get_upcoming_events` — Get upcoming events

List Minecraft events hosted through Event Alerts that have not started yet, soonest first.

**Parameters**

- `limit` (optional): Max number of events to return (default 10)

**Returns:** A list of upcoming events with title, id, start time (ISO 8601), and page URL.

### `get_event` — Get event details

Get full details for one Minecraft event by id.

**Parameters**

- `id` (required): Event id, as returned by get_upcoming_events

**Returns:** The event title, description, host (with Discord id), server (with id), time, prize, IP, platforms/version, roles, and page URL.

### `search_servers` — Search partner servers

Search Event Alerts partner servers by name, or list them all when no query is given.

**Parameters**

- `query` (optional): Case-insensitive text to match against server names and ids
- `limit` (optional): Max number of servers to return (default 10)

**Returns:** A list of partner servers with name, id, tags, and page URL.

### `get_server` — Get partner server profile

Get a partner server profile and hosting activity by id.

**Parameters**

- `id` (required): Partner server id, as returned by search_servers or get_event

**Returns:** The server name, description, invite, tags, event counts, average events per month, representatives, rating, and page URL.

### `get_player` — Get player profile

Get an Event Alerts player profile and hosting activity by Discord id.

**Parameters**

- `id` (required): Player's Discord id, as returned by get_event

**Returns:** The player username, rating, subscription tier, event counts, average events per month, represented servers, and page URL.

## Setup

### Claude (web & desktop)

Open Settings → Connectors. Click "Add custom connector". Name it "Event Alerts" and paste the endpoint URL below.

```
https://eventalerts.gg/api/mcp
```

### Claude Code

Run this in your terminal:

```
claude mcp add --transport http event-alerts https://eventalerts.gg/api/mcp
```

### Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

```
{
  "mcpServers": {
    "event-alerts": {
      "url": "https://eventalerts.gg/api/mcp"
    }
  }
}
```

### VS Code

Add this to .vscode/mcp.json:

```
{
  "servers": {
    "event-alerts": {
      "type": "http",
      "url": "https://eventalerts.gg/api/mcp"
    }
  }
}
```

### MCP Inspector

Run the command below, choose the "Streamable HTTP" transport, and connect to the endpoint URL.

```
npx @modelcontextprotocol/inspector
```