@serviceos/mcp-server

MCP (Model Context Protocol) server for ServiceOS helpdesk API. Provides 10 tools for ticket management, team/queue listing, agent stats, and SLA monitoring via stdio transport.

Setup

npm install
npm run build

Environment Variables

| Variable | Description | |----------|-------------| | SERVICEOS_BASE_URL | ServiceOS API base URL (e.g. https://your-instance.up.railway.app) | | SERVICEOS_API_KEY | API key for authentication | | SERVICEOS_ORG_ID | Organization ID |

Claude Code Configuration

Add to .claude/settings.json:

{
  "mcpServers": {
    "serviceos": {
      "command": "node",
      "args": ["packages/mcp-server/dist/index.js"],
      "env": {
        "SERVICEOS_BASE_URL": "https://...",
        "SERVICEOS_API_KEY": "sk-...",
        "SERVICEOS_ORG_ID": "org_..."
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | serviceos_list_tickets | List tickets with status/priority filters | | serviceos_get_ticket | Get ticket by ID | | serviceos_create_ticket | Create a new ticket | | serviceos_update_ticket | Update status/priority/assignee | | serviceos_list_teams | List teams | | serviceos_list_queues | List queues | | serviceos_search_tickets | Semantic search across tickets | | serviceos_get_agent_stats | Agent performance metrics | | serviceos_list_sla_breaches | List breached SLA timers | | serviceos_create_internal_note | Add internal note to a ticket |