MCP Server

Connect RotaHog to AI assistants like Claude, Cursor, and other MCP-compatible tools. Ask your AI "who's on call today?" and get a real answer. Available on Team Toolkit and Ops Pro plans.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. RotaHog's MCP server gives your AI assistant direct access to your rotation data.

Setup

1. Create an API token

Go to your API Tokens page and create a token. Use read scope for read-only access, or read_write if you want the AI to complete or manage turns.

2. Configure your MCP client

Add RotaHog to your MCP client's configuration. Here's the setup for popular clients:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "rotahog": {
      "url": "https://rotahog.com/mcp",
      "headers": {
        "Authorization": "Bearer rh_your_token_here"
      }
    }
  }
}

Cursor

In Cursor settings, add a new MCP server with:

URL: https://rotahog.com/mcp
Headers: Authorization: Bearer rh_your_token_here

3. Start using it

Once configured, you can ask your AI assistant things like:

"Who's on call this week?"
"Show me the schedule for our standup rotation"
"Mark today's deploy captain turn as complete"
"Find a substitute for my turn next week"

Available Tools

Tool	Scope	Description
`list_rotations`	read	List all rotations you own or participate in
`get_rotation`	read	Get rotation details including members and next turn
`list_turns`	read	List turns with optional status and date filters
`get_current_turn`	read	Get who's currently on duty for a rotation
`complete_turn`	read_write	Mark a turn as completed
`substitute_turn`	read_write	Assign a substitute for a turn
`cancel_turn`	read_write	Cancel an upcoming turn (owner only)

Authentication

The MCP server uses the same API tokens as the REST API. Your token is passed via the Authorization header in the MCP client configuration.

Rate limits apply: 30 requests per minute per token.

Prefer a traditional API? View REST API documentation.