AQai Change Readiness MCP Server

This MCP server lets authorized users fetch AQai assessment scores and generate PDF reports via Claude, and lets Claude Agent Skills drive that same flow. Anyone can connect by signing in with their AQai account; an administrator then grants scores/reports/skills access per user.

Endpoints

• POST /mcp — MCP Streamable HTTP endpoint
• GET /.well-known/oauth-protected-resource — OAuth protected resource metadata
• GET /.well-known/oauth-authorization-server — OAuth authorization server metadata
• POST /oauth/register — Dynamic client registration
• GET/POST /oauth/authorize — Authorization endpoint / consent (AQai platform sign-in, or an admin-issued service-account access key)
• POST /oauth/token — Token endpoint
• GET /download/:id — One-time PDF download
• GET / — Public connect guide for Claude, ChatGPT, and other MCP clients

Tools

• list_authorized_emails — emails/domains you may pull AQai data for
• list_reports — report types your account is entitled to generate
• get_skill — the full text of every skill published to your account (no arguments)
• get_aq_scores — fetch raw AQ dimension scores without generating a report (requires the AQ Scores entitlement)
• prepare_report — step 1 of 2: fetch scores + narrative schema for a report
• render_report — step 2 of 2: submit a narrative, get a PDF download link

Access model

A new connector user starts pending with no access. An administrator approves them and grants any combination of: AQ Scores (standalone score lookups), specific AQ Reports, and specific AQ Skills - either individually or via a reusable preset applied to many users at once. A separate per-user email allow/deny list controls whose AQ data a report or score lookup may target.