# Altimate Setup

> Configure Altimate platform credentials for datamate and API access

- Skill: `altimateai-altimate-code/altimate-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add altimateai-altimate-code/altimate-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/altimateai-altimate-code/altimate-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: AltimateAI (https://skillmd.com/u/altimateai-altimate-code)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/altimateai-altimate-code/altimate-setup

---


# Altimate Setup

Guide the user through configuring their Altimate platform credentials.

## Steps

1. **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.

2. **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`)

3. **Write config**: Create `~/.altimate/` directory if needed, then write `~/.altimate/altimate.json`:
   ```json
   {
     "altimateUrl": "<url>",
     "altimateInstanceName": "<instance>",
     "altimateApiKey": "<key>",
     "mcpServerUrl": "<mcp-url>"
   }
   ```
   Then set permissions to owner-only: `chmod 600 ~/.altimate/altimate.json`

4. **Validate**: Call the `datamate_manager` tool with `operation: "list"` to verify the credentials work. Report success or failure to the user.