squadcast-mcp-server
This project is an MCP Server for Squadcast designed for personal use, allowing users to manage team schedules, incidents, and status updates through an easy-to-use interface. Key features include OAuth authentication, incident management, and team selection.
MCP Server for Squadcast
This is a basic MCP Server for Squadcast. It is intended for personal use only.
Video Demo
Available tools:
- Authenticate with OAuth (Configure your refresh token in
config.json.) - List Teams
- Select Team
- Who is on call?
- Get Incidents
- Acknowledge Incidents
- Resolve Incidents
- Update Status Page
- Create Schedules
Installation - For local development
Build using NodeJS v20.19.0
-
Clone the repository
-
Install dependencies
npm install -
Rebuild Typescript dependencies
npm rebuild typescript -
Run the dev server
npm run dev
Build files (MCP Server) will be in the ./dist directory. You can use this to connect to your MCP Client.
Connecting with Claude Desktop
Refer to the "Testing your server with Claude for Desktop" to set up a local server with Claude Desktop. Point it to the dist/index.js file on your computer.
Configuration
I used the following personal preferences for Claude Desktop. Replace Your Team Name in the template:
Help me with using Squadcast.
Ensure I am authenticated before using tools.
Once authenticated, ensure a team is selected. Select <Your Team Name Here> Team by default.
Once a team is selected, answer questions related to the selected team only.
If searching for incidents, don't use periods of more than 1 day. To get the latest incidents, you can use a future end date/time
When greeted, check for any triggered incidents and let the user know. Also remind the user of any acknowledged incidents (not been resolved yet.)
When creating resources, guide the user through the options they have and request for their inputs or confirmations before creation.