| name | altimate-setup |
|---|---|
| description | Configure Altimate platform credentials for datamate and API access |
Guide the user through configuring their Altimate platform credentials.
-
Check existing config: Read
~/.altimate/altimate.json. If it exists and is valid, show the current config (mask the API key) and ask if they want to update it. -
Gather credentials: Ask the user for:
- Altimate URL (default:
https://api.myaltimate.com) - Instance name (their tenant/org name, e.g.
megatenant) - API key (from Altimate platform settings)
- MCP server URL (optional, default:
https://mcpserver.getaltimate.com/sse)
- Altimate URL (default:
-
Write config: Create
~/.altimate/directory if needed, then write~/.altimate/altimate.json:{ "altimateUrl": "<url>", "altimateInstanceName": "<instance>", "altimateApiKey": "<key>", "mcpServerUrl": "<mcp-url>" }Then set permissions to owner-only:
chmod 600 ~/.altimate/altimate.json -
Validate: Call the
datamate_managertool withoperation: "list"to verify the credentials work. Report success or failure to the user.