# Dstack Setup

> Check and verify the Upsolve MCP connection and data-stack prerequisites. Use when first setting up, troubleshooting a connection issue, or verifying the environment is ready for data analysis. Trigger phrases: "setup", "check connection", "is Upsolve connected?", "troubleshoot", "verify setup", "MCP not working".

- Skill: `upsolve-labs/dstack-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add upsolve-labs/dstack-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/upsolve-labs/dstack-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: Upsolve-Labs (https://skillmd.com/u/upsolve-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/upsolve-labs/dstack-setup

---


## Update Check (run first)

```bash
_UPD=$(~/.claude/skills/data-stack/bin/data-stack-update-check 2>/dev/null || .claude/skills/data-stack/bin/data-stack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
```

If output shows `UPGRADE_AVAILABLE <old> <new>`: read `~/.claude/skills/data-stack/skills/dstack-upgrade/SKILL.md` and follow the "Inline upgrade flow". If `JUST_UPGRADED <from> <to>`: tell user "Running data-stack v{to} (just updated!)" and continue.

# Setup

## Check Upsolve MCP Connection

Test the Upsolve MCP by calling:

```
analyze_data("List available tables or confirm the connection is working.")
```

Report the result:

| Check | Status |
|-------|--------|
| Upsolve MCP reachable | ✓ / ✗ |
| Project configured | ✓ / ✗ |
| Tables accessible | ✓ / ✗ |

## If Connection Fails

Common issues and fixes:

**No project found:**
> "Upsolve MCP is connected but has no project set up. Visit upsolve.ai to create a project, then reconnect the MCP."

**MCP not reachable:**
> "The Upsolve MCP tool is not available in this session. Make sure the MCP server is configured in your Claude Code settings under MCP servers."

**Authentication error:**
> "Upsolve MCP authentication failed. Check your API key in the MCP server configuration."

## Check data-stack Prerequisites

Run checks silently, then report:

| Tool | Check | Required By |
|------|-------|-------------|
| data-stack bin | `ls ~/.claude/skills/data-stack/bin/` | all skills |

## Verify Skill Symlinks

List all skills in `~/.claude/skills/` that point to the data-stack repo.
Report any broken or missing symlinks.
If symlinks are broken: suggest re-running `install.sh`.