📊 Team GPS CSAT MCP Server

An MCP (Model Context Protocol) server that connects Claude to your Team GPS CSAT data — bringing partner sentiment analysis, engineer scorecards, and coaching insights directly into your AI conversations.

Built for MSPs. Instead of logging into the Team GPS portal to read numbers, you ask Claude questions and get answers with context and recommendations.

⚡ Quick Start (No Install Required)

The easiest way to use this server is via npx. You don't need to download this repository or manually build it.

1. Get your Team GPS API Key: Admin Settings → Integrations → Public APIs → Copy Key.
2. Configure Claude Desktop: Open your claude_desktop_config.json and add:

{
  "mcpServers": {
    "teamgps-csat": {
      "command": "npx",
      "args": ["-y", "teamgps-csat-mcp"],
      "env": {
        "TEAMGPS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

3. Restart Claude: That's it. Claude will now have access to your CSAT tools.

🚀 What You Can Do

Once installed, you can ask Claude things like:

• "Summarise MSP Corp's CSAT for the last 90 days"
• "Which partners are at risk this month?"
• "Show me all unreviewed neutral and negative reviews"
• "How is Hampton performing across all his clients?"
• "Search all reviews for mentions of attendance"
• "Give me an org-wide CSAT digest for last month"

🛠️ Performance & Tools

| Tool | What It Does | |------|-------------| | list_companies | Lists all partner companies with review counts and scores | | get_partner_summary | Full CSAT analysis for one partner: score, trend, comments, notes | | list_at_risk_partners| Scans all partners and flags those with declining scores | | get_engineer_scorecard| Performance scorecard for a specific engineer | | find_unreviewed_concerns| All Neutral/Negative reviews not yet reviewed by management | | get_period_summary | Org-wide digest — useful for weekly reporting | | search_reviews | Search all comments and notes for a keyword (e.g. "attendance") |

📦 Developer: Publishing to npm

If you want to contribute or publish your own version publicly:

1. Requirements

• Create an account on npmjs.com
• Ensure yourself are logged in locally: npm login

2. Prepare the Code

• The folder structure should have source files in src/.
• src/index.ts must have the shebang line at the very top: #!/usr/bin/env node.

3. Build & Publish

npm install
npm run build
npm publish --access public

Once published, anyone can use it with the npx command shown in the Quick Start section.

📁 Project Structure

teamgps-csat-mcp/
├── package.json        # npm config, build scripts
├── tsconfig.json       # TypeScript config
├── README.md           # This guide
└── src/
    ├── types.ts        # Shared interfaces
    ├── api-client.ts   # HTTP layer + pagination
    ├── enricher.ts     # Data processing & analytics
    ├── date-utils.ts   # Period resolver
    └── index.ts        # MCP server core (shebang included)

📄 License

MIT © Scout Kalra — IT by Design. Part of an MSP tooling initiative to bring AI-native integrations to the managed services industry.