MCP Auth

Check a SponsorUnited email and password for the MCP sign-in

Called by the Cognito migrate-user Lambda with its own key (X-API-Key, MCP_SIGN_IN_API_KEY_TOKEN), which works on this endpoint only. Starts no session: no token, no session cache entry, no last-active write. Only 200 lets the user in. Every refusal (unknown email, wrong password, deleted, unverified, password reset pending, no use-mcp permission, no organization) is the same 401 {"error": "Invalid credentials"}; the reason goes only to the auth log. 401 {"status": "Invalid API key"} means the key is missing, wrong or another service's: a configuration error, not a user refusal. A few calls a minute per email (the Pro login retry limit) and an overall cap; the next gets 429 with Retry-After.

post/api/mcp-auth/verify-credentials

Request

Request body

emailstring email required

Email of the SponsorUnited user. Case of the letters A-Z and surrounding spaces are ignored; any other spelling (accents, full-width or other look-alike letters) is refused like an unknown email.

passwordstring password required

The user's SponsorUnited password, sent as typed.

Example request

{
  "email": "director@sponsorunited.com"
}

Response

The credentials are valid and the user may use MCP.

user_idinteger required
organization_idinteger required

Example response

{
  "user_id": 42,
  "organization_id": 7
}

Changes

No recorded changes to this operation across all 2 revisions of this API.