TOOL Authentication
OMS Login
anamaya_login
Authenticate an Anamaya OMS user. MCP caches the JWT in memory (TTL ~50 minutes) and returns profile fields with token_cached: true — never the JWT string.
Authorization
Optional MCP gate: Authorization: Bearer <MAYA_ANAMAYA_MCP_API_TOKEN>.
Required OMS identity: pass email and password on the tool call.
MCP caches the OMS JWT server-side and never returns it to the LLM.
Parameters
| Name | Type | Example | Description |
|---|---|---|---|
email Required | string | user@company.com | OMS user email. Required on inventory and mutation tools (unless demo server env defaults are set). |
password Required | string | •••••••• | OMS user password. MCP exchanges this for a JWT and caches it server-side — the JWT is never returned to the LLM. |
force | boolean | false | When true, clear any cached JWT and force a fresh OMS login. |
Notes
- OMS login is required for inventory and mutations. This is not OAuth.
- Optional MCP gate token (Bearer MAYA_ANAMAYA_MCP_API_TOKEN) is separate — it only opens the MCP endpoint.
- On OMS 401/403 mid-session, MCP clears the cache and retries login once.